繁中 ▾
取得 API 金鑰

kimiapikey.com指南

在 Cursor 中使用 Kimi 風格 API 金鑰:設定指南

Cursor 可連線至任何 OpenAI 相容端點,因此連接到此 API 只需四個欄位和約兩分鐘。本指南涵蓋確切數值、證明金鑰有效的測試,以及你最可能遇到的錯誤。

更新於

等距插圖:程式編輯器透過發光電纜連接到 API 伺服器

重點摘要

  • Cursor 需要三個值:你的金鑰、Base URL https://api.kimiapikey.com/v1 以及模型名稱 uncensored。
  • 先用 curl 測試金鑰,以便輕鬆區分是 Cursor 端問題還是 API 端問題。
  • 代理模式編輯會傳送大量提示詞,因此請留意輸入 token:每 1M 輸入 $0.15,每 1M 輸出 $0.50。
  • 試用金鑰允許 2 個並行請求,Cursor 的代理可能會超出此限制。完整金鑰允許 8 個並行請求。

簡短答案

如果你正在搜尋如何在 cursor 中使用 kimi api key,首先要知道的是,由其他提供者發行的金鑰僅適用於該提供者的端點。本站的金鑰適用於本站的端點,Cursor 接受它因為該端點使用 OpenAI chat completions 格式。你貼上金鑰,將 Cursor 指向不同的 Base URL,並新增一個自訂模型名稱。

完整的設定順序如下:

  1. 建立帳戶並從API 金鑰頁面複製你的金鑰。
  2. 開啟 Cursor,前往設定,然後到模型。
  3. 將金鑰貼到 OpenAI API 金鑰欄位。
  4. 開啟 Base URL 覆寫並輸入https://api.kimiapikey.com/v1。
  5. 新增名為uncensored的自訂模型並在聊天中選取它。

本文其餘部分將解釋每個步驟,提供在編輯器外測試連線的方法,並列出通常會出錯的地方。

此金鑰是什麼以及不是什麼

本站提供單一開放權重模型的存取權,由獨立供應商託管,並針對合法成人用途進行微調,使其在回答時不會因內容審查而拒絕。這不是 Moonshot、Kimi 或其他任何廠商的官方 API,也不是將你的請求轉寄至他人模型的轉發器。本站名稱反映的是人們搜尋的內容,而非實際營運者。如果你已經持有來自其他廠商的金鑰,請繼續使用該廠商的端點。本站金鑰與其他廠商金鑰不可互換。

你獲得的是標準的 OpenAI 風格 API:POST /v1/chat/completions 與 GET /v1/models、Bearer token 驗證、100,000 token 的上下文視窗、串流輸出、函式呼叫與 JSON 模式。僅支援文字。沒有影像生成、嵌入或微調功能,這在編輯器中很重要,因為依賴這些功能的 Cursor 功能將不會使用此端點。Kimi API 金鑰說明 將更詳細地說明命名方式與替代方案。

對於程式開發而言,「無審查」具有實際意義。模型不會因為變數名稱或測試固定資料看起來敏感而在任務中途停止。針對你自己擁有之系統的資安工具、包含雜亂字串的日誌解析器、爬蟲、小說生成器以及內容審核測試集,這些在其他地方容易觸發拒絕的工作類型,在這裡則不會。硬性限制仍然存在:絕對不會出現涉及未成年人的性內容。

Cursor 逐步設定

1. 取得金鑰和試用額度

使用 Google 或電子郵件與密碼註冊。在 API 金鑰頁面,你可以一鍵領取 $0.50 的試用額度。無需綁定信用卡,有效期為 7 天,每人限領一次。這足以應付數百次一般聊天請求,讓你在付費前完成整個指南。

2. 開啟模型設定

在 Cursor 中,開啟設定並找到模型區塊。選單標籤在不同版本間可能會移動,因此請尋找命名為 OpenAI API 金鑰的欄位,以及命名為覆寫 OpenAI Base URL 的開關或欄位。這兩個設定最為重要。

3. 填入三個數值

Cursor 欄位說明
OpenAI API 金鑰來自儀表板的金鑰
覆寫 OpenAI Base URLhttps://api.kimiapikey.com/v1
自訂模型名稱uncensored

精確輸入 Base URL。它以/v1結尾,沒有尾隨斜線,也沒有/chat/completions,因為用戶端會自行新增路徑。貼上包含完整路徑的 URL 會產生 404 錯誤,且錯誤訊息很少說明原因。

4. 選取模型並發送訊息

開啟聊天面板,從模型清單中選取uncensored,並詢問小問題,例如「寫一個解析 ISO 日期的函式」。如果回覆以串流輸出顯示,則設定完成。如果 Cursor 顯示錯誤,不要隨機更改設定。前往下一節並直接測試端點。

5. 了解覆寫的副作用

Base URL 覆寫通常適用於你在 Cursor 中使用的所有 OpenAI 風格模型,不僅限於自訂模型。如果你稍後切換回標準 OpenAI 模型,請先關閉覆寫,否則你的請求將發送至此端點,但該端點不支援該模型名稱。

在歸咎編輯器之前先測試金鑰

花兩分鐘操作終端機,可節省一小時的猜測。此請求模擬了 Cursor 的行為:使用 Bearer token 傳送聊天補全請求。

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": "Reply with the word ready."}],
    "max_tokens": 20
  }'

包含choices陣列的 JSON 主體表示金鑰、URL 和模型名稱都正確。也請檢查回應標頭。X-Balance-USD顯示剩餘額度,X-Request-Id值得保留以便日後追蹤請求。

使用官方 OpenAI SDK 的相同 Python 檢查:

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": "Reply with the word ready."}],
    max_tokens=20,
)
print(resp.choices[0].message.content)

你也可以使用GET /v1/models列出模型。Cursor 和類似用戶端在按下驗證按鈕時有時會呼叫它,因此模型呼叫正常是一個好跡象。如果 curl 正常但 Cursor 不行,問題出在編輯器設定,下表涵蓋了通常的情況。

當模型在編輯器中撰寫程式碼時會發生什麼變化

側邊面板中的聊天費用低廉。帶有數百 token 上下文的短問題,費用不到一分錢。附加檔案、搜尋結果和對話歷史的編輯器功能費用較高,因為每個請求都會再次攜帶所有內容。模型擁有 100,000 token 的視窗,提示詞與回覆共用此空間,如果你附加大型資料夾,Cursor 會毫不猶豫地填滿大部分空間。

這裡有一個實際計算。假設請求攜帶 40,000 個輸入 token,模型寫入 1,500 個 token 回覆:

  • 輸入:40,000 / 1,000,000 x $0.15 = $0.006
  • 輸出:1,500 / 1,000,000 x $0.50 = $0.00075
  • 總計:每次請求 $0.00675,因此 100 次此類請求成本為 $0.675

對於一個繁忙的下午來說,這遠低於一美元,但輸入端佔主導地位,因此節省資金的習慣是附加較少的檔案,而不是提較短的問題。當主題改變時開始新的聊天,因為舊的歷史記錄在每次交談中都會再次付費。

API 支援函式呼叫,這是代理樣式編輯功能所依賴的。模型決定呼叫工具,你的用戶端執行它並將結果以role: "tool"訊息返回。任何模型驅動多步驟代理的能力取決於模型本身,因此在將重構任務交給它之前,請先在小任務上測試。API 背後的單一開放權重模型意味著你只會得到一種行為,而不是可供選擇的選單。

在 Cursor 自有模型上運行的 Cursor 功能(例如其標籤自動完成)通常不會因自訂金鑰而切換。請檢查 Cursor 目前的文件,了解哪些功能接受自訂 OpenAI 風格端點,因為該清單在版本之間會變化。

常見錯誤及其修復方法

症狀可能原因修復方法
404 或「找不到」Base URL 包含端點路徑,或缺少/v1請精確使用https://api.kimiapikey.com/v1
401 未授權貼上的金鑰有多餘的空格或換行,或是過期的金鑰從儀表板重新複製金鑰並再次貼上
找不到模型模型名稱輸入不同使用 uncensored,全小寫,不要其他內容
429 錯誤,代碼為 concurrency你的金鑰同時發送的請求過多等待進行中的請求完成,或使用完整金鑰(8 個並行)
429 錯誤,代碼為 rate_limited超過每分鐘的配額放慢速度;試用金鑰每分鐘允許 60 次請求,完整金鑰每分鐘 300 次
429 錯誤,帶有 Retry-After: 5 標頭暫時過載五秒後重試
驗證按鈕失敗,但 curl 正常運作略過驗證步驟,直接傳送真實的聊天訊息略過驗證步驟,直接傳送真實的聊天訊息

並行錯誤值得特別說明,因為它常讓試用金鑰的使用者感到驚訝。試用金鑰允許 2 個並行請求,而一個同時啟動多個作業的代理程式可能會超過此限制,且過程中你並未進行任何操作。串流輸出也會佔用槽位,直到串流結束為止,因此長回應會一直佔用一個槽位。完整金鑰允許 8 個並行請求和每分鐘 300 次請求,對單一開發者來說相當寬鬆。

失敗和遭拒的請求不會計費,因此錯誤後重試不會產生額外費用。你可以在 文件頁面 上查看完整的限制資訊。

試用額度耗盡後付費

沒有訂閱制。你可以以 $20 至 $500 之間的任意整數金額儲值預付額度,請求會以每 100 萬個輸入 token $0.15 和每 100 萬個輸出 token $0.50 的費率消耗額度。額度永不過期,因此如果一個月沒有編碼需求,就不會產生費用。儲值 $50 或以上享有獎勵:$50 起 +5%,$100 起 +10%,$200 起 +15%。你可以使用加密貨幣(TRC20 上的 USDT、Base 上的 USDC)付款。定價頁面 集中顯示了目前的費率。

使用前述的 40,000 輸入、1,500 輸出的請求,$20 的儲值大約可支援 2,960 次此類請求($20 / $0.00675)。大多數編輯器請求較小,因此實際可支援的次數會更高。你的提示詞不會用於訓練,這在貼上的程式碼屬於客戶時尤為重要。

使用前述的 40,000 輸入、1,500 輸出的請求,$20 的儲值大約可支援 2,960 次此類請求($20 / $0.00675)。大多數編輯器請求較小,因此實際可支援的次數會更高。你的提示詞不會用於訓練,當貼上的程式碼屬於客戶時,這一點很重要。

常見問題

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

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

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

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

問答

我可以將 Moonshot 或 Kimi 金鑰搭配此 Base URL 放入 Cursor 嗎?

不行。金鑰僅適用於發行該金鑰的提供者端點。請在此處使用來自你儀表板的金鑰,或將其他金鑰保留給其對應提供者的 URL 使用。

我在 Cursor 中應輸入什麼模型名稱?

輸入 uncensored,需為小寫。這是此 API 提供的唯一模型 ID,輸入其他名稱會返回模型未找到的錯誤。

它支援 Cursor 的代理模式嗎?

API 支援函式呼叫,這是代理功能所需的。模型完成長篇多步驟任務的可靠性因情況而異,因此在執行大型任務前,建議先在小型任務上進行測試。

為什麼試用金鑰會出現 429 錯誤?

試用金鑰允許 2 個並行請求和每分鐘 60 次請求。完整金鑰允許 8 個並行請求和每分鐘 300 次請求,Retry-After: 5 標頭表示短暫的超載,你可以稍後重試。

我的程式碼會被用於訓練嗎?

不行。傳送至 API 的提示詞不會用於訓練。

只差一張表單,即可取得金鑰

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

取得 API 金鑰閱讀文件