mistralai/client-python

Mistral Python Client – クイック概要

概要: Mistral AIのクラウドサービス（チャット補完、埋め込み、オーディオ、ファイル処理、エージェント、および各種管理API）を呼び出すための公式Python SDKです。独自の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) 用のクライアントが用意されており、認証とエンドポイント構築を自動的に処理します。

はじめ方

インストール – pip install mistralai (または uv add mistralai)。
APIキーの設定 – MISTRAL_API_KEY をエクスポートするか、MISTRAL_SA_TOKEN_PATH にサービスアカウントトークンファイルを指定します。

コードの記述 – 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)

サンプルの実行 – リポジトリ内の examples/ フォルダにあるサンプルを uv run で実行できます。

重要性: このSDKはHTTPの詳細、トークンのローテーション、ページネーション、ストリーミングを抽象化します。これにより、開発者はMistralの大規模言語モデルを活用したアプリケーション（チャットボット、RAGパイプライン、音声アシスタントなど）の構築に集中できます。

mistralai/client-python

Mistral Python Client – クイック概要

関連