API 文件說明 - KimiCode

基礎 URL 與驗證

透過更新基礎 URL 並在標頭中提供金鑰將您的程式碼連接到我們的 API。我們支援標準身份驗證，因此現有的 OpenAI SDK 客戶端可立即使用，無需複雜設定。透過 Google 或電子郵件註冊後，您的 API 金鑰會立即顯示，無需電話號碼。

每個帳戶同時僅擁有一個有效金鑰；生成新金鑰會取代舊金鑰。請求透過 Authorization 標頭進行身份驗證，確保您的預付信用額度存取安全。

首次請求

使用標準的聊天補全端點和簡單的 POST 請求發送第一條訊息。這能確認您的整合在深入進階功能或串流資料之前即可運作。回應會從無審查模型返回文本輸出。

• 將 YOUR_API_KEY 替換為您從儀表板取得的金鑰。
• 將模型設定為 'uncensored' 以使用我們特定的開放權重模型。

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

Python SDK 集成

使用官方的 OpenAI Python 函式庫透過將其指向我們的 base URL 來與我們的 API 互動。此方法利用了熟悉的語法，使您能夠在不重寫整個應用程式邏輯的情況下切換供應商。函式庫會自動處理分詞與請求格式化。

• 透過 pip 安裝 openai 套件。
• 將基礎 URL 配置為指向我們的服務。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicodepricing.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 SDK 整合

使用 Node SDK 將我們的 API 整合至您的 JavaScript 或 TypeScript 應用程式。這確保了前端與後端環境行為的一致性。您可以傳遞訊息並接收回應，就像使用任何標準 OpenAI 相容服務一樣。

Copyimport OpenAI from "openai";

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

串流與 token 使用量

啟用串流以透過伺服器發送事件（SSE）接收即時 Token 生成。這可降低使用者的感知延遲並允許立即顯示部分結果。Token 用量資料（包括輸入和輸出計數）嵌入在串流的最後一個區塊中。

這種方法非常適合需要即時反饋的聊天界面。你可以解析流以逐步更新 UI，而無需等待整個響應。

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)

限制、錯誤與上下文

透過了解速率限制和常見錯誤程式碼來管理您的用量。API 支援 100,000 令牌的上下文視窗，允許深度的對話歷史。您的限制為每分鐘 300 次請求，且每個金鑰最多 8 個併發請求。

• 401 表示 API 金鑰無效或缺失。
• 402 表示您的預付額度已耗盡。
• 429 表示您已超過速率限制。

錯誤不會消耗您的信用額，因此您可以無懲罰地重試失敗的請求。