fix: add examples

Author: jean-malo

examples/async_batch_jobs.py

@@ -0,0 +1,13 @@
+import asyncio
+
+from mistralai import Mistral
+
+client = Mistral()
+
+async def main():
+    await client.batch.jobs.create_async(
+        endpoint="/v1/ocr"
+    )
+    print("Job created")
+
+asyncio.run(main())

examples/audio_chat_base64.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python
+import base64
+import os
+
+from mistralai import Mistral
+from mistralai.models import UserMessage
+
+
+
+def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-small-latest"
+
+    client = Mistral(api_key=api_key)
+    with open("examples/files/bcn_weather.mp3", "rb") as f:
+        content = f.read()
+    chat_response = client.chat.complete(
+        model=model,
+        messages=[UserMessage(content=[
+            {"type": "text", "text": "What's in this audio file?"},
+            {
+                "type": "input_audio",
+                "input_audio": base64.b64encode(content).decode('utf-8'),
+            },
+        ])],
+    )
+    print(chat_response.choices[0].message.content)
+
+
+if __name__ == "__main__":
+    main()

examples/audio_chat_no_streaming.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python
+
+import os
+
+from mistralai import Mistral
+from mistralai.models import UserMessage
+
+
+
+def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-small-latest"
+
+    client = Mistral(api_key=api_key)
+
+    chat_response = client.chat.complete(
+        model=model,
+        messages=[UserMessage(content=[
+            {"type": "text", "text": "What is this audio about?"},
+            {
+                "type": "input_audio",
+                "input_audio": "https://docs.mistral.ai/audio/bcn_weather.mp3",
+            },
+        ])],
+    )
+    print(chat_response.choices[0].message.content)
+
+
+if __name__ == "__main__":
+    main()

examples/audio_chat_streaming.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+
+import os
+
+from mistralai import Mistral, File
+from mistralai.models import UserMessage
+
+
+
+def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-small-latest"
+
+    client = Mistral(api_key=api_key)
+    with open("examples/files/bcn_weather.mp3", "rb") as f:
+        file = client.files.upload(file=File(content=f, file_name=f.name), purpose="audio")
+        print(f"Uploaded audio file, id={file.id}")
+        signed_url = client.files.get_signed_url(file_id=file.id)
+    try:
+        chat_response = client.chat.stream(
+            model=model,
+            messages=[UserMessage(content=[
+                {"type": "text", "text": "What is this audio about?"},
+                {
+                    "type": "input_audio",
+                    "input_audio": signed_url.url,
+                },
+            ])],
+        )
+        for chunk in chat_response:
+            print(chunk.data.choices[0].delta.content)
+    finally:
+        client.files.delete(file_id=file.id)
+        print(f"Deleted audio file, id={file.id}")
+
+if __name__ == "__main__":
+    main()

examples/audio_transcription_async.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+
+import os
+import asyncio
+from mistralai import Mistral, File
+
+
+async def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-mini-latest"
+
+    client = Mistral(api_key=api_key)
+    with open("examples/files/bcn_weather.mp3", "rb") as f:
+        response = await client.audio.transcriptions.complete_async(
+            model=model,
+            file=File(content=f, file_name=f.name),
+        )
+        print(response.text)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/audio_transcription_segments.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python
+
+import os
+
+from mistralai import Mistral
+
+
+def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-mini-latest"
+
+    client = Mistral(api_key=api_key)
+    response = client.audio.transcriptions.complete(
+        model=model,
+        file_url="https://docs.mistral.ai/audio/bcn_weather.mp3",
+        timestamp_granularities=["segment"],
+    )
+    print(response.text)
+    print(response.segments)
+
+
+if __name__ == "__main__":
+    main()

examples/audio_transcription_segments_stream.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python
+
+import os
+
+from mistralai import Mistral
+
+
+def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-mini-latest"
+
+    client = Mistral(api_key=api_key)
+    response = client.audio.transcriptions.stream(
+        model=model,
+        file_url="https://docs.mistral.ai/audio/bcn_weather.mp3",
+        timestamp_granularities=["segment"],
+    )
+    for chunk in response:
+        print(chunk)
+
+
+if __name__ == "__main__":
+    main()

examples/audio_transcription_stream_async.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python
+import asyncio
+import os
+
+from mistralai import Mistral, File
+
+
+async def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-mini-2507"
+
+    client = Mistral(api_key=api_key)
+    with open("examples/files/bcn_weather.mp3", "rb") as f:
+        response = await client.audio.transcriptions.stream_async(
+            model=model,
+            file=File(content=f, file_name=f.name),
+        )
+        async for chunk in response:
+            print(chunk.event, chunk.data)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/audio_transcription_url.py

@@ -0,0 +1,21 @@
+#!/usr/bin/env python
+
+import os
+
+from mistralai import Mistral
+
+
+def main():
+    api_key = os.environ["MISTRAL_API_KEY"]
+    model = "voxtral-mini-latest"
+
+    client = Mistral(api_key=api_key)
+    response = client.audio.transcriptions.complete(
+        model=model,
+        file_url="https://docs.mistral.ai/audio/bcn_weather.mp3",
+    )
+    print(response.text)
+
+
+if __name__ == "__main__":
+    main()