mistralai/client-python

什么是 Mistral Python Client？

该仓库提供了 Mistral AI 的云服务（聊天补全、嵌入、音频、文件处理、代理等）的官方 Python SDK。它允许开发者从 Python 代码中调用 Mistral 的 REST API（支持同步和 asyncio 异步），而无需手动编写 HTTP 请求。

主要功能（如 README 所述）

领域	使用 SDK 可以实现的操作
聊天补全	使用 `mistral-large-latest` 等模型生成文本响应。支持流式传输和自定义响应格式。
嵌入	通过 `mistral-embed` 获取一个或多个输入字符串的向量嵌入。
文件上传	将文件上传到工作区（例如用于微调或检索增强生成）。
代理	调用保持状态交互的代理端点，支持同步和异步 API。
音频	支持语音合成（`Audio.Speech`）和语音转录（`Audio.Transcriptions`），包括通过 Server-Sent Events 实现的流式转录。
批量任务	列出、创建、取消和删除长时间运行的批量任务。
Beta 资源	管理代理、连接器、对话、库和文档（创建、列出、更新、删除、分页等）。
云服务商封装	提供 Azure AI 和 Google Cloud（Vertex AI）的预设客户端，自动处理端点构建、认证和令牌刷新。
实用工具	内置分页、重试、错误处理、自定义 HTTP 客户端注入、遥测钩子和 IDE 友好的类型提示。

快速入门

获取 API 密钥：从 Mistral 控制台（或使用 Azure/GCP 时从其平台）获取 API 密钥。导出为 MISTRAL_API_KEY（或特定提供商的环境变量）。
安装包：以下任一方式均可：
```
# uv（快速安装器）
uv add mistralai

# pip（默认）
pip install mistralai

# poetry
poetry add mistralai
```
若需使用代理相关功能，请额外安装：pip install "mistralai[agents]"（需 Python 3.10+）。

编写一个小程序（同步示例）：

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": "谁是最佳的法国画家？"}],
        stream=False,
        response_format={"type": "text"},
    )
    print(resp)

相同模式也适用于 async with Mistral(...): 和 *_async 方法。

何时使用此 SDK？

构建需要可靠、类型安全的 Python 接口的 LLM 驱动应用（聊天机器人、助手、RAG 流水线）。
将 Mistral 模型集成到现有 Python 服务中，而无需处理原始 HTTP。
利用 Mistral 的扩展生态系统——音频生成、转录、批量处理，或最新的代理和 连接器 功能。
在 Azure 或 Google Cloud 上部署——SDK 包含轻量封装（MistralAzure、MistralGCP），可自动处理提供商特定的认证和端点构建。

项目结构

mistralai.client.Mistral — 核心客户端，暴露子对象（chat、embeddings、files、agents、audio 等）。
提供商特定模块（mistralai.azure.client、mistralai.gcp.client）——继承核心客户端，预设基础 URL 和认证流程。
详尽文档：每个资源的 docs/ 文件夹中均有详细文档，examples/ 目录可通过 uv run 运行。

TL;DR

Mistral Python Client 是一个功能完整、官方支持的 SDK，用于封装 Mistral AI 的云 API。通过 pip（或 uv/poetry）安装，设置 API 密钥后，即可从 Python 直接发起聊天、嵌入、音频、文件和代理调用，支持同步和异步。它还包含 Azure AI 和 Google Cloud 的预设适配器，是任何使用现代 LLM 服务的 Python 开发者的便捷入口。