API 文件

驗證與 Base URL

首先將您的客戶端指向正確的基礎 URL。我們接受標準的 OpenAI 標頭以確保兼容性。您的 API 金鑰作為 bearer token 放入 Authorization 標頭。直接從環境變數傳遞以避免硬編碼機密。此設定適用於任何支援 OpenAI 協議的程式庫。

首次請求

發送簡單的聊天完成請求以驗證連線能力。使用模型 ID "uncensored" 進行文字生成。該端點回傳標準 JSON，包含選項和用量指標。若收到 401 錯誤，請檢查您的金鑰格式。402 錯誤表示預付餘額不足。此快速測試可確認您的整合已準備好處理生產環境的流量。

Copycurl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

Python SDK 集成

配置 OpenAI Python 包以使用我們的 base URL。明確設置 API 金鑰和模型名稱。將您的消息作為包含 role 和 content 鍵的字典列表傳遞。回應對象在 choices[0].message.content 中包含生成的文本。在執行期間優雅地處理異常以捕獲網絡或速率限制錯誤。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralbaseurl.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)

Node.js SDK 設置

使用您的基礎 URL 和金鑰初始化 OpenAI 客戶端。定義包含使用者和助手角色的 messages 陣列。呼叫 chat.completions.create 並指定 uncensored 模型。回應會在第一個選項中提供生成的文字。此模式適用於 Node 應用程式中的同步和非同步呼叫。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralbaseurl.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);

串流回應

透過將 stream 設為 true 來啟用串流。API 會隨著資料生成傳送區塊。每個區塊包含您可以附加至緩衝區的 delta 文字。這種方法可降低長輸出時的感知延遲。在最後一個區塊中監控 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)

Limits & Context Window

您的帳戶支援 100,000 個 token 的上下文視窗。每次請求的最大輸出為 16,000 個 token。您每分鐘可發送 300 次請求。同時僅限 8 個請求運行。主體大小超過 8MB 的請求將失敗。利用這些限制來設計您的重試邏輯。429 等錯誤表示觸及速率限制。拒絕請求不會消耗信用額度。