mistralai 1.1.0__tar.gz → 1.2.1__tar.gz

{mistralai-1.1.0 → mistralai-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mistralai
-Version: 1.1.0
+Version: 1.2.1
 Summary: Python Client SDK for the Mistral AI API.
 Home-page: https://github.com/mistralai/client-python.git
 Author: Mistral
@@ -11,6 +11,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Provides-Extra: gcp
 Requires-Dist: eval-type-backport (>=0.2.0,<0.3.0)
 Requires-Dist: google-auth (==2.27.0) ; extra == "gcp"
@@ -205,7 +206,8 @@ s = Mistral(
 
 res = s.agents.complete(messages=[
     {
-        "content": "<value>",
+        "content": "Who is the best French painter? Answer in one short sentence.",
+        "role": "user",
     },
 ], agent_id="<value>")
 
@@ -237,6 +239,53 @@ async def main():
         # handle response
         pass
 
+asyncio.run(main())
+```
+
+### Create Embedding Request
+
+This example shows how to create embedding request.
+
+```python
+# Synchronous Example
+from mistralai import Mistral
+import os
+
+s = Mistral(
+    api_key=os.getenv("MISTRAL_API_KEY", ""),
+)
+
+res = s.embeddings.create(inputs=[
+    "Embed this sentence.",
+    "As well as this one.",
+], model="Wrangler")
+
+if res is not None:
+    # handle response
+    pass
+```
+
+</br>
+
+The same SDK client can also be used to make asychronous requests by importing asyncio.
+```python
+# Asynchronous Example
+import asyncio
+from mistralai import Mistral
+import os
+
+async def main():
+    s = Mistral(
+        api_key=os.getenv("MISTRAL_API_KEY", ""),
+    )
+    res = await s.embeddings.create_async(inputs=[
+        "Embed this sentence.",
+        "As well as this one.",
+    ], model="Wrangler")
+    if res is not None:
+        # handle response
+        pass
+
 asyncio.run(main())
 ```
 <!-- End SDK Example Usage [usage] -->
@@ -347,11 +396,26 @@ The documentation for the GCP SDK is available [here](https://github.com/mistral
 * [complete](https://github.com/mistralai/client-python/blob/master/docs/sdks/agents/README.md#complete) - Agents Completion
 * [stream](https://github.com/mistralai/client-python/blob/master/docs/sdks/agents/README.md#stream) - Stream Agents completion
 
+### [batch](https://github.com/mistralai/client-python/blob/master/docs/sdks/batch/README.md)
+
+
+#### [batch.jobs](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md)
+
+* [list](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#list) - Get Batch Jobs
+* [create](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#create) - Create Batch Job
+* [get](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#get) - Get Batch Job
+* [cancel](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#cancel) - Cancel Batch Job
+
 ### [chat](https://github.com/mistralai/client-python/blob/master/docs/sdks/chat/README.md)
 
 * [complete](https://github.com/mistralai/client-python/blob/master/docs/sdks/chat/README.md#complete) - Chat Completion
 * [stream](https://github.com/mistralai/client-python/blob/master/docs/sdks/chat/README.md#stream) - Stream chat completion
 
+### [classifiers](https://github.com/mistralai/client-python/blob/master/docs/sdks/classifiers/README.md)
+
+* [moderate](https://github.com/mistralai/client-python/blob/master/docs/sdks/classifiers/README.md#moderate) - Moderations
+* [moderate_chat](https://github.com/mistralai/client-python/blob/master/docs/sdks/classifiers/README.md#moderate_chat) - Moderations Chat
+
 ### [embeddings](https://github.com/mistralai/client-python/blob/master/docs/sdks/embeddings/README.md)
 
 * [create](https://github.com/mistralai/client-python/blob/master/docs/sdks/embeddings/README.md#create) - Embeddings
@@ -362,6 +426,7 @@ The documentation for the GCP SDK is available [here](https://github.com/mistral
 * [list](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#list) - List Files
 * [retrieve](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#retrieve) - Retrieve File
 * [delete](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#delete) - Delete File
+* [download](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#download) - Download File
 
 ### [fim](https://github.com/mistralai/client-python/blob/master/docs/sdks/fim/README.md)
 
@@ -504,12 +569,23 @@ if res is not None:
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-Handling errors in this SDK should largely match your expectations.  All operations return a response object or raise an error.  If Error objects are specified in your OpenAPI Spec, the SDK will raise the appropriate Error type.
+Handling errors in this SDK should largely match your expectations. All operations return a response object or raise an exception.
+
+By default, an API error will raise a models.SDKError exception, which has the following properties:
+
+| Property        | Type             | Description           |
+|-----------------|------------------|-----------------------|
+| `.status_code`  | *int*            | The HTTP status code  |
+| `.message`      | *str*            | The error message     |
+| `.raw_response` | *httpx.Response* | The raw HTTP response |
+| `.body`         | *str*            | The response content  |
+
+When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `list_async` method may raise the following exceptions:
 
-| Error Object               | Status Code | Content Type     |
-| -------------------------- | ----------- | ---------------- |
-| models.HTTPValidationError | 422         | application/json |
-| models.SDKError            | 4xx-5xx     | */*              |
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| models.HTTPValidationError | 422                        | application/json           |
+| models.SDKError            | 4XX, 5XX                   | \*/\*                      |
 
 ### Example
 
@@ -545,9 +621,9 @@ except models.SDKError as e:
 
 You can override the default server globally by passing a server name to the `server: str` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the names associated with the available servers:
 
-| Name   | Server                   | Variables |
-| ------ | ------------------------ | --------- |
-| `prod` | `https://api.mistral.ai` | None      |
+| Name | Server | Variables |
+| ----- | ------ | --------- |
+| `eu` | `https://api.mistral.ai` | None |
 
 #### Example
 
@@ -556,7 +632,7 @@ from mistralai import Mistral
 import os
 
 s = Mistral(
-    server="prod",
+    server="eu",
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 )
 
@@ -678,9 +754,9 @@ s = Mistral(async_client=CustomClient(httpx.AsyncClient()))
 
 This SDK supports the following security scheme globally:
 
-| Name      | Type | Scheme      | Environment Variable |
-| --------- | ---- | ----------- | -------------------- |
-| `api_key` | http | HTTP Bearer | `MISTRAL_API_KEY`    |
+| Name                 | Type                 | Scheme               | Environment Variable |
+| -------------------- | -------------------- | -------------------- | -------------------- |
+| `api_key`            | http                 | HTTP Bearer          | `MISTRAL_API_KEY`    |
 
 To authenticate with the API the `api_key` parameter must be set when initializing the SDK client instance. For example:
 ```python

{mistralai-1.1.0 → mistralai-1.2.1}/README-PYPI.md

@@ -180,7 +180,8 @@ s = Mistral(
 
 res = s.agents.complete(messages=[
     {
-        "content": "<value>",
+        "content": "Who is the best French painter? Answer in one short sentence.",
+        "role": "user",
     },
 ], agent_id="<value>")
 
@@ -212,6 +213,53 @@ async def main():
         # handle response
         pass
 
+asyncio.run(main())
+```
+
+### Create Embedding Request
+
+This example shows how to create embedding request.
+
+```python
+# Synchronous Example
+from mistralai import Mistral
+import os
+
+s = Mistral(
+    api_key=os.getenv("MISTRAL_API_KEY", ""),
+)
+
+res = s.embeddings.create(inputs=[
+    "Embed this sentence.",
+    "As well as this one.",
+], model="Wrangler")
+
+if res is not None:
+    # handle response
+    pass
+```
+
+</br>
+
+The same SDK client can also be used to make asychronous requests by importing asyncio.
+```python
+# Asynchronous Example
+import asyncio
+from mistralai import Mistral
+import os
+
+async def main():
+    s = Mistral(
+        api_key=os.getenv("MISTRAL_API_KEY", ""),
+    )
+    res = await s.embeddings.create_async(inputs=[
+        "Embed this sentence.",
+        "As well as this one.",
+    ], model="Wrangler")
+    if res is not None:
+        # handle response
+        pass
+
 asyncio.run(main())
 ```
 <!-- End SDK Example Usage [usage] -->
@@ -322,11 +370,26 @@ The documentation for the GCP SDK is available [here](https://github.com/mistral
 * [complete](https://github.com/mistralai/client-python/blob/master/docs/sdks/agents/README.md#complete) - Agents Completion
 * [stream](https://github.com/mistralai/client-python/blob/master/docs/sdks/agents/README.md#stream) - Stream Agents completion
 
+### [batch](https://github.com/mistralai/client-python/blob/master/docs/sdks/batch/README.md)
+
+
+#### [batch.jobs](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md)
+
+* [list](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#list) - Get Batch Jobs
+* [create](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#create) - Create Batch Job
+* [get](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#get) - Get Batch Job
+* [cancel](https://github.com/mistralai/client-python/blob/master/docs/sdks/mistraljobs/README.md#cancel) - Cancel Batch Job
+
 ### [chat](https://github.com/mistralai/client-python/blob/master/docs/sdks/chat/README.md)
 
 * [complete](https://github.com/mistralai/client-python/blob/master/docs/sdks/chat/README.md#complete) - Chat Completion
 * [stream](https://github.com/mistralai/client-python/blob/master/docs/sdks/chat/README.md#stream) - Stream chat completion
 
+### [classifiers](https://github.com/mistralai/client-python/blob/master/docs/sdks/classifiers/README.md)
+
+* [moderate](https://github.com/mistralai/client-python/blob/master/docs/sdks/classifiers/README.md#moderate) - Moderations
+* [moderate_chat](https://github.com/mistralai/client-python/blob/master/docs/sdks/classifiers/README.md#moderate_chat) - Moderations Chat
+
 ### [embeddings](https://github.com/mistralai/client-python/blob/master/docs/sdks/embeddings/README.md)
 
 * [create](https://github.com/mistralai/client-python/blob/master/docs/sdks/embeddings/README.md#create) - Embeddings
@@ -337,6 +400,7 @@ The documentation for the GCP SDK is available [here](https://github.com/mistral
 * [list](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#list) - List Files
 * [retrieve](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#retrieve) - Retrieve File
 * [delete](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#delete) - Delete File
+* [download](https://github.com/mistralai/client-python/blob/master/docs/sdks/files/README.md#download) - Download File
 
 ### [fim](https://github.com/mistralai/client-python/blob/master/docs/sdks/fim/README.md)
 
@@ -479,12 +543,23 @@ if res is not None:
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-Handling errors in this SDK should largely match your expectations.  All operations return a response object or raise an error.  If Error objects are specified in your OpenAPI Spec, the SDK will raise the appropriate Error type.
+Handling errors in this SDK should largely match your expectations. All operations return a response object or raise an exception.
+
+By default, an API error will raise a models.SDKError exception, which has the following properties:
+
+| Property        | Type             | Description           |
+|-----------------|------------------|-----------------------|
+| `.status_code`  | *int*            | The HTTP status code  |
+| `.message`      | *str*            | The error message     |
+| `.raw_response` | *httpx.Response* | The raw HTTP response |
+| `.body`         | *str*            | The response content  |
+
+When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `list_async` method may raise the following exceptions:
 
-| Error Object               | Status Code | Content Type     |
-| -------------------------- | ----------- | ---------------- |
-| models.HTTPValidationError | 422         | application/json |
-| models.SDKError            | 4xx-5xx     | */*              |
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| models.HTTPValidationError | 422                        | application/json           |
+| models.SDKError            | 4XX, 5XX                   | \*/\*                      |
 
 ### Example
 
@@ -520,9 +595,9 @@ except models.SDKError as e:
 
 You can override the default server globally by passing a server name to the `server: str` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the names associated with the available servers:
 
-| Name   | Server                   | Variables |
-| ------ | ------------------------ | --------- |
-| `prod` | `https://api.mistral.ai` | None      |
+| Name | Server | Variables |
+| ----- | ------ | --------- |
+| `eu` | `https://api.mistral.ai` | None |
 
 #### Example
 
@@ -531,7 +606,7 @@ from mistralai import Mistral
 import os
 
 s = Mistral(
-    server="prod",
+    server="eu",
     api_key=os.getenv("MISTRAL_API_KEY", ""),
 )
 
@@ -653,9 +728,9 @@ s = Mistral(async_client=CustomClient(httpx.AsyncClient()))
 
 This SDK supports the following security scheme globally:
 
-| Name      | Type | Scheme      | Environment Variable |
-| --------- | ---- | ----------- | -------------------- |
-| `api_key` | http | HTTP Bearer | `MISTRAL_API_KEY`    |
+| Name                 | Type                 | Scheme               | Environment Variable |
+| -------------------- | -------------------- | -------------------- | -------------------- |
+| `api_key`            | http                 | HTTP Bearer          | `MISTRAL_API_KEY`    |
 
 To authenticate with the API the `api_key` parameter must be set when initializing the SDK client instance. For example:
 ```python

{mistralai-1.1.0/src/mistralai → mistralai-1.2.1/packages/mistralai_azure/src/mistralai_azure}/__init__.py

@@ -1,5 +1,9 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
+from ._version import __title__, __version__
 from .sdk import *
 from .sdkconfiguration import *
 from .models import *
+
+
+VERSION: str = __version__

mistralai-1.2.1/packages/mistralai_azure/src/mistralai_azure/_version.py

@@ -0,0 +1,12 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+import importlib.metadata
+
+__title__: str = "mistralai_azure"
+__version__: str = "1.2.0"
+
+try:
+    if __package__ is not None:
+        __version__ = importlib.metadata.version(__package__)
+except importlib.metadata.PackageNotFoundError:
+    pass