アプリケーションから Mistral を呼び出す

最初のリクエストの前に

Mistral Studio でプロバイダーAPIキーを作成してください。サーバーに保管し、公開リポジトリやブラウザーバンドルには絶対に含めないでください。アカウントのモデルアクセスと現在の料金を確認してください。このウェブサイトのアカウント認証情報はプロバイダーとは別です。

cURL クイックスタート

コード

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large-4",
    "messages": [{"role": "user", "content": "Explain idempotent retries."}],
    "max_tokens": 1024
  }'

Python の例

公式の mistralai SDK をパッケージレジストリからインストールし、キーには環境変数を使用してください。

コード

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
reply = client.chat.complete(
    model="mistral-large-4",
    messages=[{"role": "user", "content": "Explain idempotent retries."}],
    max_tokens=1024,
)
print(reply.choices[0].message.content)

TypeScript の例

サーバーで公式の @mistralai/mistralai SDK を使用してください。結果をレンダリングする前に、選択肢の欠如とプロバイダーエラーを処理してください。

コード

import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const reply = await client.chat.complete({
  model: "mistral-large-4",
  messages: [{ role: "user", content: "Explain idempotent retries." }],
  maxTokens: 1024,
});
console.log(reply.choices?.[0]?.message.content);

ストリーミング応答

HTTP API では、ストリーミングをリクエストし、サーバー送信イベントを段階的に解析してください。各ネットワークチャンクに1つの完全なイベントが含まれるとは限りません。部分的なテキストを保持し、キャンセルをサポートし、完了した応答と切断された接続を区別してください。副作用を重複させることなくアプリケーションが実行できる場合にのみ再試行してください。

画像とドキュメント

マルチモーダルコンテンツブロックについては、現在のAPIリファレンスに従ってください。許可された画像を使用し、公開URLを検証してください。ドキュメントに関する質問では、ソースの抜粋を含め、明示的な引用を求めてください。プロバイダーのリクエスト制限がモデルの文書化されたコンテキストより低い場合は、大きな入力を分割してください。

構造化出力とツール

検証されていないJSONを求めるのではなく、サポートされている構造化出力スキーマを使用してください。ツール呼び出しを実行する前に引数を検証し、サーバーで認可を強制し、ツールループを制限してください。モデルが生成した関数呼び出しは、アクションを実行する許可ではなく、提案された入力です。

本番環境チェックリスト

出力制限、タイムアウト、同時実行制限を設定してください。シークレットや不要なユーザーコンテンツをログに記録せずに、モデル識別子、使用状況、エラーを追跡してください。レート制限、部分ストリーム、キャンセル、不正なツール引数をテストしてください。プロバイダーのフォールバックと小さな回帰評価セットを維持してください。

このワークスペースでの利用可能性

上記の統合は公式プロバイダーを直接対象としています。ブラウザーチャットとクレジット管理にはワークスペースアカウントを使用してください。直接APIの例は独自のプロバイダーアカウントが必要で、この記事からは実行されません。