mistralai/client-python

Mistral Python Client – 快速概览

是什么：这是用于调用 Mistral AI 云端服务的官方 Python SDK，涵盖聊天补全、嵌入、音频、文件处理、代理程序以及一系列管理 API。它让您能通过自己的 Python 代码与 Mistral 模型进行交互，并支持同步与 asyncio 异步调用。

主要功能

• 聊天与代理程序 – 简单的 mistral.chat.complete(...) 与 mistral.agents.complete(...) 调用，并支持可选的流式传输功能。
• 嵌入 – 使用 mistral.embeddings.create(...) 进行文本向量化。
• 文件上传 – 通过 mistral.files.upload(...) 上传工作区文件。
• 音频 – 语音合成与转录端点。
• 批处理作业、库、连接器、对话 – 完整管理 Mistral 资源（例如用于 RAG 的文档库）。
• 异步支持 – 每个操作都有对应的 *_async 版本。
• 服务器发送事件 (SSE) – 通过 SSE 进行流式响应。
• 内置分页、重试与错误处理机制。
• 云服务商封装 – 为 Azure AI 与 Google Cloud (Vertex AI) 提供现成的客户端，自动处理验证与端点构建。

如何开始

1. 安装 – pip install mistralai (或 uv add mistralai)。
2. 设置 API 密钥 – 导出 MISTRAL_API_KEY 或将 MISTRAL_SA_TOKEN_PATH 指向服务账户令牌文件。
3. 编写代码 – 导入 Mistral 并调用所需方法，例如：

   from mistralai.client import Mistral
   import os
   
   with Mistral(api_key=os.getenv("MISTRAL_API_KEY")) as client:
       resp = client.chat.complete(
           model="mistral-large-latest",
           messages=[{"role": "user", "content": "Hello!"}],
           stream=False,
       )
       print(resp)
   

4. 运行示例 – 仓库中附带 examples/ 文件夹，您可以使用 uv run 运行。

为什么这很重要：此 SDK 抽象化了 HTTP 细节、令牌轮换、分页与流式处理，让开发者能专注于构建应用程序（如聊天机器人、RAG 流水线、语音助手等），充分利用 Mistral 的大型语言模型。