Kimi 用戶快速上手
替換新的 base URL 與 API 金鑰,即可將現有的 OpenAI SDK 呼叫路由至無審查 LLM。本指南將展示啟動聊天、串流輸出與使用工具所需的確切三行程式碼。
前置條件:API 金鑰
發送請求前,你需要一個 API 金鑰。在 取得 API 金鑰 頁面使用 使用 Google 繼續登入 或電子郵件與密碼註冊。你的金鑰會立即顯示。新帳戶會獲得 $0.50 的免費試用額度,有效期為 7 天;無需信用卡。付費使用時,請使用 USDT (TRC20) 或 USDC (Base) 儲值。儲值金額介於 $10 至 $500 之間。儲值 $50 或以上可獲得 +5% 贈額,儲值 $100 或以上可獲得 +10% 贈額。額度永不過期,僅根據實際 token 用量計費。錯誤與拒絕請求均免費。每個帳戶只能保留一個有效金鑰;生成新金鑰會取代舊金鑰。在所有請求中,請將此金鑰用於Authorization 標頭。
基本聊天補全
kimi api 端點接受標準的 OpenAI 聊天完成請求。將客戶端的基礎 URL 設為 https://api.kimiapi.cc/v1 並提供你的金鑰。我們提供單一專屬的無審查模型,其 ID 為 uncensored。此模型為開放權重模型,運行於我們的伺服器上,不會拒絕合法的成人、虛構或具爭議性的主題。它不是 GPT、Claude、Gemini 或其他廠商的模型。你可以傳送提示詞並接收文字回應。該模型支援 100,000 token 的上下文視窗(提示詞 + 補全)。每個請求的最大輸出為 32,000 token;若未設定 max_tokens,則為 2,048 token。不產生嵌入向量、圖片或音訊。
串流回應
使用伺服器發送事件(SSE)進行串流輸出。API 會在生成 token 時進行串流輸出。token 使用資訊包含在串流的最後一個區塊中。這讓你能即時監控成本,無需等待完整回應。所有標準的 OpenAI 相容 SDK 都支援串流輸出。在請求中設定stream=true。客戶端將收到包含文字的增量物件序列。你可以將這些增量物件連接起來以重建完整回應。這非常適合使用者期望立即回饋的聊天介面。kimi api 透過避免代理伺服器額外負荷,確保可預測的延遲。
函式呼叫(工具)
API 支援函式呼叫,也稱為工具。你可以在請求中定義工具,模型會在適當時返回結構化的參數。使用tools 參數傳遞工具定義列表。你也可以使用 tool_choice 強制或自動選擇工具。模型會返回包含工具呼叫的回應,你可以將其傳回 API 以繼續對話。這有助於建構代理程式或自動化工作流程。工具定義遵循標準的 OpenAI 格式。無審查模型能準確處理工具定義,不會拒絕在有效用例中使用它們。JSON 模式也可用於更嚴格的輸出格式。
JSON 模式
對於需要嚴格輸出的應用程式,請使用 JSON 模式。將response_format 設為 {"type": "json_object"}。模型將嘗試返回有效的 JSON 物件。這對於解析資料、生成組態檔或將結構化資料餵入其他系統很有用。JSON 模式與函式呼叫同時運作。你也可以設定 temperature、top_p、stop、seed、presence_penalty 和 frequency_penalty 等參數來控制創造力與確定性。這些參數是 OpenAI 相容用戶端的標準參數。根據您的使用案例調整這些參數,以平衡一致性和創造力。
限制、錯誤與上下文
每個 API 金鑰的速率限制為每分鐘 300 次請求,並行請求上限為 8 個。請求主體不得超過 8 MB。如果金鑰無效,您會收到 401 錯誤。如果沒有額度,您會收到 402 錯誤。如果超過速率限制,您會收到 429 錯誤。錯誤與拒絕請求均免費,因此失敗的請求不會計費。上下文視窗總共為 100,000 個 token。有嚴格內容限制:涉及未成年人的性內容請求一律會被拒絕。API 僅支援文字。不提供嵌入、影像或微調功能。對於其他供應商的模型,請查看其文件以獲取當前價格和限制。此服務為獨立替代方案,與上述供應商無隸屬關係。
cURL
curl https://api.kimiapi.cc/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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapi.cc/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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapi.cc/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 = 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)技術規格
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| Base URL | https://api.kimiapi.cc/v1 |
| 模型 ID | uncensored |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| JSON 模式 | response_format: {"type": "json_object"} |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 請求大小 | 每次請求不超過 8 MB |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 儲值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整數金額 |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 登入 | Google 或電子郵件 + 密碼 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
錯誤代碼
錯誤以 JSON 回傳,type 欄位固定;失敗或被拒絕的請求不計費。
| 狀態碼 | 類型 | 含義 |
|---|---|---|
400 | bad_request | JSON 無效、訊息為空、參數錯誤或超出上下文視窗 |
401 | missing_key · invalid_key · key_revoked | 缺少金鑰、金鑰錯誤或已被新金鑰取代 |
402 | no_credit | 餘額不足——儲值後立即恢復 |
403 | content_blocked | 涉及未成年人的性內容——拒絕且不計費 |
404 | not_found | 未知端點 |
413 | request_too_large | 請求內容超過 8 MB |
429 | rate_limited · concurrency | 超過每分鐘 300 次或 8 個並行——稍後重試 |
503 | upstream_busy | 模型忙碌——幾秒後重試 |
問答
上下文視窗與輸出限制為何?
上下文視窗為 100,000 token(提示詞與補全合計)。每次請求的最大輸出為 32,000 token。若未設定 <code>max_tokens</code>,限制為 2,048 token。
我該如何為額度儲值?
僅接受加密貨幣儲值:USDT (TRC20) 或 USDC (Base)。接受金額為 10 美元至 500 美元的整數。儲值 50 美元以上可獲 +5% 贈額,儲值 100 美元以上可獲 +10% 贈額。額度永不過期。
這是官方的 Kimi API 嗎?
不是。這是提供 OpenAI 相容端點的獨立服務。我們提供單一無審查模型。我們與 Moonshot AI 或其他供應商無隸屬關係。請查閱各供應商的文件以獲取其官方 API。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改 base URL。這就是整個設定。