從你的應用程式呼叫 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，請求串流並逐步解析伺服器傳送事件。不要假設每個網路區塊都包含一個完整事件。保留部分文字，支援取消，並區分已完成的回應與中斷的連線。僅在您的應用程式能夠重試而不會重複副作用時才重試。

圖片與文件

請遵循多模態內容區塊的最新 API 參考文件。使用授權圖片並驗證公開網址。對於文件問題，請包含來源段落並要求明確引用。當供應商的請求限制低於模型文件所述的情境時，請將大型輸入內容分割。

結構化輸出與工具

使用支援的結構化輸出結構描述，而非要求未驗證的 JSON。在執行工具呼叫之前驗證參數，在您的伺服器上強制執行授權，並限制工具迴圈。模型產生的函式呼叫是建議的輸入，而非執行動作的許可。

生產環境檢查清單

設定輸出限制、逾時與並行限制。追蹤模型識別碼、用量與錯誤，但不要記錄密鑰或不必要的使用者內容。測試速率限制、部分串流、取消與格式錯誤的工具參數。保留供應商備援方案與小型回歸評估集。

在此工作區的可用性

上述整合直接針對官方供應商。請使用工作區帳戶進行瀏覽器聊天與點數管理。直接 API 範例需要您自己的供應商帳戶，無法從本文執行。