Mistral API 金鑰：快速入門指南

前置條件：SDK 與環境

開始安裝您偏好的與 OpenAI 相容的 SDK。您只需要有效的 API 金鑰和我們服務的基本 URL。

將密鑰導出到您的環境變量，以便您的腳本可以安全訪問它。通過 Google 或電子郵件創建新帳戶以立即獲取密鑰。此步驟無需電話號碼驗證。

確保您的環境支援標準 HTTP 函式庫。API 要求所有請求均使用標準 JSON 資料載體。您無需安裝供應商專屬的驅動程式。

設定 Base URL

將您的 SDK 客戶端指向我們專用於無審查推理的端點。基礎 URL 將取代您配置中的標準 OpenAI 端點。

使用 HTTPS://api.apikeymistral.com/v1 作為您的基礎 URL。這可確保所有請求都通過我們的高吞吐量伺服器。如果您的 SDK 預設為 /chat/completions，則無需更改端點路徑。

將您的 API 金鑰保留在記憶體或安全的金鑰庫中。該金鑰會驗證您發送至此 URL 的每個請求。

進行首次 POST 請求

發送標準聊天完成請求以獲取文本輸出。使用模型 ID "uncensored" 來存取我們調整過的模型。

指定溫度和其他參數以控制創意。該端點接受帶有消息數組的標準 JSON 主體。

這是一個測試連線性的基本 curl 命令：

Copycurl https://api.apikeymistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json object with keys name age"}]
  }'

驗證回應包含生成的文本。檢查狀態碼是否為 200 表示成功。

Python SDK 整合

配置 Python 客戶端以使用我們的 base URL。使用您的 API 金鑰和自定義端點初始化客戶端。

呼叫 chat.completions.create 方法並傳入您的提示詞。回應物件會在 choices[0].message.content 中包含生成的文字。

優雅地處理潛在錯誤，例如速率限制或無效的金鑰。如果需要追蹤成本，請記錄 token 用量。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apikeymistral.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

此方法適用於任何 OpenAI 相容的函式庫。您可以以最小的變更重用現有程式碼。

Node SDK 整合

使用自訂基礎 URL 初始化 Node.js 用戶端。在設定物件中傳遞您的 API 金鑰。

使用您所需的參數呼叫 chat.completions.create 函數。回應遵循標準 OpenAI 格式。

根據需要處理串流或最終回應。錯誤處理應能捕捉網路問題或驗證失敗。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikeymistral.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

此設定允許您快速將無審查推論整合到您的 Node 應用程式中。

處理串流回應

透過在請求中設定 stream=true 來啟用串流。API 隨著生成以區塊形式回傳資料。

處理每個數據塊以向您的用戶顯示實時輸出。累積內容以獲取完整回應。

在串流的最後一個區塊中監控 token 用量。這有助於您準確追蹤成本。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

串流可降低長篇回應的感知延遲。它非常適合聊天介面和互動式應用程式。

限制、錯誤與上下文視窗

了解技術限制以避免服務中斷。上下文視窗支援提示詞與補全合計 100,000 個 token。

每個請求的最大輸出為 16,000 個 Token。請明確設定 max_tokens 以避免達到 2,048 的預設值。

速率限制允許每金鑰每分鐘 300 次請求。您同時可進行 8 個併發請求。

透過檢查金鑰有效性來處理 401 錯誤。402 錯誤表示額度不足。429 錯誤表示您已達到速率限制。

超過 8 MB 主體大小限制的請求將失敗。請相應地規劃您的負載。