5 分鐘內完成首次請求

安裝 OpenAI Python/Node SDK

首先安裝標準 OpenAI 客戶端程式庫。由於我們的 API 遵循相同的 OpenAI 相容介面，因此可以運作。您無需特殊的供應商 SDK。只需執行 pip install openai (Python) 或 npm install openai (Node.js)。該程式庫會自動處理 JSON 序列化與 HTTP 請求。

設定基礎 URL 與 API 金鑰

將您的客戶端指向我們的端點。將基礎 URL 設定為 https://api.kimiapi.top/v1，並提供來自儀表板的 API 金鑰。此金鑰用於驗證您的預付額度。您可以在註冊頁面透過 Google 或電子郵件即時產生新金鑰。開始使用無需信用卡。

Copycurl https://api.kimiapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

發送首次聊天補全請求

向 uncensored 模型發送簡單訊息。該模型經過調整，可針對合法成人用途無拒絕地回答。它支援 100,000-token 上下文視窗，但最大輸出為 32,000 個 token。回應會直接回傳文字。錯誤與拒絕不會消耗您的額度。

Copyfrom openai import OpenAI

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

啟用 SSE 串流輸出

對於即時回應，請啟用串流輸出。SDK 透過伺服器發送事件 (SSE) 串流輸出 token。最後一個區塊包含用於計費的總 token 用量。此方法可降低長輸出的感知延遲。您可以在應用程式邏輯中處理每個到達的 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)

使用 JSON 模式進行結構化輸出

透過將 response_format 設為 {"type": "json_object"}，確保機器可讀的輸出。這會強制模型回傳有效的 JSON。它非常適合資料擷取或設定檔產生。模型不會破壞結構，讓你在程式碼中解析回應變得更容易。

Copyimport OpenAI from "openai";

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

檢查用量與費用

透過儀表板監控你的用量。輸入成本為每百萬 token $0.25；輸出為每百萬 token $1.00。若收到 401，請檢查你的金鑰。402 代表你需要儲值 USDT 或 USDC。429 表示你達到了每分鐘 300 次請求的速率限制。額度永不過期，方便時再儲值即可。