快速入門：連接您的客戶端

先決條件與 SDK 安裝

安裝您所用語言的官方 SDK，以自動處理身份驗證和請求序列化。您需要一個有效的 API 金鑰，並在客戶端環境中配置基礎 URL。我們的服務接受標準參數（如 temperature 和 top_p），無需自訂標頭。

確保您的環境變數在執行任何腳本前已安全儲存您的 token。SDK 版本必須為最新，以正確支援串流與 JSON mode 功能。純文字生成無需額外驅動程式。

配置基礎 URL 和金鑰

將您的客戶端指向我們的特定基礎 URL，讓請求通過我們的無審查基礎設施。使用標頭 Authorization: Bearer YOUR_KEY 來驗證每次呼叫。此設定對於本地測試或生產部署腳本均適用。

以我們的託管主機取代預設的 OpenAI 端點，以避免與其他供應商混淆。保持您的金鑰私密，不要將其暴露在公共儲存庫中。配置保持靜態，直到您輪換金鑰為止。

發送您的第一個請求

執行標準的聊天完成呼叫以驗證連線與回應格式。發送簡單提示以確認模型回傳文字且無拒絕回應。此測試確保您的金鑰具有足夠的預付信用以進行使用。

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

檢查響應中的內容和 token 使用詳情。如果您收到 401 錯誤，請驗證您的密鑰格式。402 表示您需要為積分餘額充值。

處理串流回應

即時串流接收權杖。這降低了使用者等待長輸出時的感知延遲。最後一個區塊包含最終權杖計數以確保計費準確性。

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)

在客戶端程式碼中優雅地處理部分回應。在串流結束或發生錯誤前緩衝內容。串流支援所有標準參數，包括溫度調整。

Python SDK 集成

使用 Python 程式庫以最小的程式碼範本管理請求。使用您的 base URL 和金鑰初始化客戶端即可立即使用。這種方式簡化了錯誤處理和回應解析。

Copyfrom openai import OpenAI

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

從回應物件直接存取生成的內容。檢查錯誤並適當處理速率限制。SDK 支援同步和非同步工作流程。

Node SDK 與限制

使用官方 JavaScript SDK 將 Node.js 應用程式進行整合。設定基礎 URL 以確保請求到達我們的無審查端點。監控您的使用情況以保持在速率限制內。

Copyimport OpenAI from "openai";

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

每個金鑰每分鐘可發送 300 次請求，併發上限為 8 個。每個請求主體必須低於 8 MB。上下文視窗總共支援 100,000 個 token。錯誤與拒絕不消耗信用額度，但成功輸出的 token 會消耗。請妥善保管您的金鑰，如有需要請進行更換。

了解 Token 使用量

計費基於提示詞和補全中使用的實際 Token。輸入 Token 每百萬收費 $0.15，輸出 Token 每百萬收費 $0.50。預付信用額度涵蓋所有用量，無月度費用。

錯誤與拒絕均免費，您只需為成功的回應付費。串流中的最後一個區塊包含 token 計數。請監控您的儀表板以追蹤支出，避免額度耗盡。可使用 USDT 或 USDC 充值以立即取得額度。