Kimicode：5 分鐘完成首次請求

基礎 URL 與驗證

首先將你的客戶端指向我們的基礎 URL：https://api.kimicode.top/v1。每個請求都需要 API 金鑰。點擊網站上的 取得 API 金鑰 來產生金鑰。使用 Google 登入或電子郵件與密碼。不需要手機號碼。金鑰在建立後立即顯示。請妥善保管；每個帳戶只有一個有效金鑰。如果你產生新金鑰，舊金鑰將失效。將金鑰作為 Bearer token 傳入 Authorization 標頭。

首次請求

向聊天完成端點發送你的第一個提示詞。使用模型 ID uncensored。API 接受標準的 OpenAI 相容格式。輸入提示詞，輸出文字。錯誤和拒絕請求不收費，你只需為成功的 token 使用付費。使用簡單提示詞測試連線。

複製curl https://api.kimicode.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."}]
  }'

如果金鑰無效，你會收到 401 錯誤。如果額度不足，你會收到 402 錯誤。如果請求意外失敗，請檢查帳戶餘額。

Python SDK 整合

使用官方的 OpenAI Python SDK。將基礎 URL 設定為我們的端點。傳入你的 API 金鑰。客戶端會自動處理請求格式。這適用於任何支援 OpenAI 相容客戶端的語言。透過 pip 安裝函式庫。使用你的基礎 URL 和金鑰設定客戶端。使用聊天完成端點發送訊息。回應包含生成的文字。你可以直接從回應物件解析內容。

複製from openai import OpenAI

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

確保你的程式碼能優雅地處理例外狀況。網路問題或速率限制可能需要重試。

Node SDK 用法

Node.js SDK 的運作方式相同。匯入客戶端。設定基礎 URL 和 API 金鑰。呼叫聊天完成方法。傳入模型 ID 和訊息陣列。回應結構符合 OpenAI 格式。提取助手訊息內容。此方法適用於伺服器端生成或邊緣函式。除了更改基礎 URL 外，不需要其他設定。

複製import OpenAI from "openai";

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

透過檢查狀態碼來處理錯誤。速率限制會返回 429。資金不足會返回 402。

串流回應

透過設定 stream: true 啟用串流。API 返回伺服器發送事件 (SSE)。每個區塊包含部分內容。token 使用詳情出現在最後一個區塊。這可降低長輸出時的感知延遲。妥善處理串流終止。當串流結束或發生錯誤時關閉連線。支援 SSE 的標準客戶端均可使用串流。

複製stream = 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。每個請求的最大輸出為 32,000 token。若未設定 max_tokens，請設為 2,048。速率限制為每分鐘 300 個請求（每支金鑰）。並行請求限制為 8 個同時請求。請求主體最大為 8 MB。錯誤包含：無效金鑰返回 401，無額度返回 402，速率限制返回 429。額度永不過期。錯誤請求免費。無訂閱陷阱。