繁中 ▾
取得 API 金鑰

kimiapikey.com指南

Moonshot API Base URL:將程式碼指向其他位置

Moonshot API Base URL 只是您 OpenAI 風格客戶端中的一個字串,更改它是將相同程式碼指向不同供應商的方法。本頁顯示該字串在 Python、Node.js、curl 和常見工具中的位置,以及如何將其指向替代端點。

更新於

電纜在配線板上的兩個插座之間移動,說明 API Base URL 已更改
等距插圖:程式編輯器透過發光電纜連接到 API 伺服器

重點摘要

  • Base URL 是單一設定;請求主體保持 OpenAI 聊天格式。
  • 切換時更改三項內容:Base URL、API 金鑰、模型 ID。
  • 我們的端點為 https://api.kimiapikey.com/v1,模型 ID 為 uncensored。
  • 這是一個獨立託管模型,並非 Moonshot 的官方服務,因此請重新測試您的提示詞。

Base URL 實際上的作用

OpenAI 相容的用戶端由兩個部分構成每個請求:基底 URL 與路徑。SDK 會將兩者結合,因此呼叫 chat.completions.create 會變成對 <base_url>/chat/completions 的 POST 請求。遵循此格式的供應商(包含 Moonshot)會在其文件中公布各自的基底 URL。請至該處查詢,而非從論壇貼文複製,因為這是唯一無法猜測的值。

因此切換供應商需要三項修改,且無需其他操作:

  1. Base URL,決定請求去向。
  2. API 金鑰,由供應商發行,僅在其伺服器上有效。
  3. 模型 ID,因為每個供應商對其模型的命名不同。

訊息、角色、串流輸出、工具和 JSON 模式保持相同結構,這就是為什麼遷移過程很簡短。任何依賴供應商特定功能(如內建網頁搜尋工具)的內容都需要單獨處理。

將這三個值保存在一個配置塊或每個供應商的環境文件中也有幫助。當 Base URL、金鑰和模型 ID 並排時,切換回來只需一行更改,並避免新金鑰與舊地址配對的半遷移狀態。

Python:openai 套件

在 Python 中,建立客戶端時設定 Base URL。此範例連接到本站的端點:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.kimiapikey.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)

若希望程式碼中不含設定值,請改用環境。當您呼叫 OpenAI() 且未傳入任何參數時,SDK 會讀取 OPENAI_BASE_URL 與 OPENAI_API_KEY,因此部署環境可在不更動程式碼的情況下切換供應商。請注意,這也表示殼層中殘留的變數可能會覆蓋您在檔案中設定的值。

Node 和 curl

官方 JavaScript 套件使用相同的選項名稱,採用駝峰式命名:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.kimiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Hello" }],
  stream: false,
});
console.log(resp.choices[0].message.content);

如果完全不使用 SDK,Base URL 只是地址的前綴:

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

同一個端點也接受 POST /v1/responses,而 GET /v1/models 則列出其提供的服務。在所有情況下,驗證方式均為在 Authorization 標頭中使用 Bearer token。

編輯器和聊天前端

GUI 工具會以不同標籤顯示 API 基底:「API base」、「Override OpenAI Base URL」、「Custom endpoint」或「Provider URL」。你貼上的值與上述程式碼中的字串相同,以 /v1 結尾。除非工具明確要求完整 URL,否則不要貼上完整的 /chat/completions 位址。

儲存後,如果工具未獲取列表,請手動新增模型 ID。某些編輯器會針對固定供應商驗證金鑰並拒絕自訂值,在這種情況下,請先尋找開啟自訂或 OpenAI 相容模式的設定。在 Cursor 中使用 Kimi 風格 API 金鑰 的文章詳細介紹了其中一個工具。

切換供應商時會發生什麼變化

格式匹配並不意味著行為匹配。在將生產流量轉移之前,請逐一檢查以下項目:

  • 輸出風格。 不同的模型寫法不同。運行您的真實提示詞,而非玩具範例。
  • 上下文大小。 此端點的上下文視窗為 100,000 token,用於提示詞加上補全。如果您的當前設置發送更長的提示詞,請先修剪它們。
  • 限制。 完整金鑰允許 8 個並行請求和每分鐘 300 個請求。超過任一限制時,您將收到 HTTP 429,代碼為 rate_limited 或 concurrency。
  • 功能。 支援 SSE 串流輸出、函式呼叫和 JSON 模式。不支援圖像、音頻和視頻生成、嵌入和微調;這是一個僅文本的 API。
  • 命名。 該服務運行一個開放權重模型,旨在為合法成人用戶提供無內容拒絕的回答。它不是 Moonshot 的官方 API,也不是跨供應商的路由器。

將相同的十個提示詞分別發送至兩個端點並記錄結果,並排閱讀答案,這是一種中立的比較方式。這只需幾分鐘,即可省去猜測。

Base URL 的常見錯誤及其表現

切換後的大多數故障來自地址,而非金鑰。以下是每個錯誤的表現形式及其修復方法。

錯誤症狀修復方法
僅主機,無 /v1每次呼叫都返回 404在末尾新增 /v1
貼上完整路徑錯誤中出現重複路徑的 404將地址截斷回 /v1
尾隨斜杠加上手動路徑連接URL 中的雙斜杠讓 SDK 拼接路徑
舊金鑰,新 URL401使用新供應商發行的金鑰
舊 URL,新金鑰來自舊供應商的 401在儲存庫和殼層中搜索舊地址
http:// 而非 https://重定向或連接錯誤在所有地方使用 https

查找殘留項的快速方法是搜索您的專案和部署設定中的舊主機名。查看 .env 文件、CI 變數、Docker compose 文件和任何編輯器設定,因為一個遺漏的副本就足以將一些流量發送到舊供應商。

切換後的串流輸出和工具

設定 stream: true,回覆將以伺服器發送事件(SSE)形式到達,並在結尾報告 token 使用量。工具呼叫使用常規的 tools 和 tool_choice 欄位,串流傳回的 tool_calls 及結果會以帶有 role: "tool" 的訊息形式回傳。如果您的程式碼已為舊供應商處理這些內容,它應能繼續運作;在完全切換前,請先執行一次串流呼叫和一次工具呼叫以確認。請記住,串流請求會佔用並行請求槽位,直到串流結束為止。

切換前的成本檢查

此處的計費按 token 計算:每 1M 輸入 token $0.15,每 1M 輸出 token $0.50,從預付額度扣款,無訂閱費。失敗或被拒絕的請求不收費,且額度不會過期。對於其他供應商的費率,請查看其當前定價頁面,因為這些費率會變動。

一個具體範例。假設請求包含 2,000 個輸入 token 和 500 個輸出 token:

  • 輸入:2,000 / 1,000,000 x $0.15 = $0.0003
  • 輸出:500 / 1,000,000 x $0.50 = $0.00025
  • 總計:每次請求 $0.00055,因此 1,000 次請求費用為 $0.55

最低儲值金額為 $20,較高金額可獲贈額外紅利:$50 起贈 5%,$100 起贈 10%,$200 起贈 15%。僅支援加密貨幣(TRC20 上的 USDT、Base 上的 USDC)。完整資訊請見 定價頁面,Kimi 專屬說明請見 Kimi API 金鑰定價。

取得金鑰並執行首次請求

使用 Google 或電子郵件與密碼註冊,然後開啟 API 金鑰頁面。新用戶可一鍵領取 $0.50 的試用額度,每人限領一次,有效期 7 天且無需綁定信用卡。試用金鑰限同時進行 2 個並行請求,每分鐘限 60 次,對測試而言已足夠。

將金鑰貼入上方的 Python 程式碼片段並執行,確認能收到文字回應。文件列出了所有參數,回應標頭 X-Request-Id 與 X-Balance-USD 有助於除錯與追蹤餘額。傳送給服務的提示詞不會用於訓練。

常見問題

該模型與 Moonshot 官方的 Kimi 相同嗎?
不,我們託管了一個經過微調以實現無審查的開放權重模型。它不是 GPT、Claude、Gemini、Grok、DeepSeek 或其他供應商提供的模型。這是一個運行在我們自有伺服器上的獨立模型。

你會在訓練中使用我的資料嗎?
不會。你的提示詞與生成內容不會用於訓練。我們重視隱私與透明度,因此你的資料始終歸你所有。

速率限制為何?
每個金鑰每分鐘限 300 個請求。請求主體的最大大小為 8 MB。這些限制旨在確保所有使用者的穩定效能。

內容政策為何?
該模型對於成人、爭議性及創意主題為無審查。然而,我們會封鎖涉及未成年人的性內容。這是硬性限制,無論你的訂閱等級為何,皆會適用。

問答

更換 Base URL 時需要修改程式碼嗎?

通常只需修改三個值:Base URL、API 金鑰與模型 ID。只要新供應商支援,訊息格式、串流輸出與函式呼叫的格式皆保持不變。

Base URL 需要以 /v1 結尾嗎?

此端點支援:https://api.kimiapikey.com/v1. SDK 會自行加上 /chat/completions,因此請勿包含此路徑。

這是 Moonshot 的官方 API 嗎?

不是。這是一個獨立託管的開放權重模型,透過 OpenAI 相容的 API 提供服務。它並非 Moonshot 的服務,也不是跨供應商的轉發路由器。

我該在哪裡找到模型 ID?

使用你的金鑰呼叫 GET /v1/models。在此端點上,模型 ID 為 uncensored。

只需填寫表單即可取得金鑰

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。

取得 API 金鑰閱讀文件