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 開發者的便捷入門點。