Kimi API怎麼用：API Key獲取、Python調用、K3價格與429報錯處理

適用於誰

• 搜「kimi api key 獲取」「kimi api 開放平台」「kimi api 價格」「kimi k3 api」的開發者；
• 買了 Kimi 會員，想知道能不能拿會員額度調 API 的人；
• 調用時遇到 401、429、model_not_found 的人。

本文根據 Kimi API 開放平台官方文檔和 Kimi 幫助中心的 API 文章整理，資料核對於 2026-10-11。

結論先說

1. API 開放平台是 platform.kimi.com（原 platform.moonshot.cn 已跳轉到這裏），和聊天用的 kimi.com 帳號體系、計費都是分開的。
2. API 只按量計費，沒有訂閱制。Kimi 會員的額度不能拿來調開放平台的 API；Kimi Code 的 Key 和開放平台的 Key 也不通用。
3. 接口兼容 OpenAI SDK：base_url 填 https://api.moonshot.cn/v1，模型名填 kimi-k3 等。
4. 國內站和國際站互相隔離：platform.kimi.com 對應 api.moonshot.cn，platform.kimi.ai 對應 api.moonshot.ai，帳戶和 Key 不能混用。
5. 新用戶認證後有 15 元代金券，但官方寫明代金券不能用於 Kimi K3，用 K3 需要先充值。

步驟

1. 註冊並完成實名認證

打開 platform.kimi.com 登入。在用戶中心完成實名認證：

• 個人認證：按頁面提示完成實名；
• 企業認證：需要企業名稱、同名銀行帳號和統一社會信用代碼，平台會向企業帳戶打一筆隨機小額款項，由財務確認金額後填回。

官方說明認證後可以獲得更高的速率限制、開發票等權益；個人可以轉企業（餘額和用量保留），企業不能轉個人。使用國內手機號註冊的新用戶，完成實名認證後贈送 15 元代金券，有效期 3 個月，扣費時優先使用。

2. 創建 API Key

進入控制台的 API Keys 頁面，創建並複製密鑰，存到環境變量裏（官方示例用的變量名是 MOONSHOT_API_KEY）：

bash
export MOONSHOT_API_KEY="你的 Key"      # Windows PowerShell：$env:MOONSHOT_API_KEY="你的 Key"

不要把 Key 寫進代碼或提交到 Git 倉庫。

3. 發出第一個請求

官方快速開始要求 Python 3.8 及以上，並安裝 1.0 以上版本的 openai 庫：

bash
pip install --upgrade 'openai>=1.0'

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.cn/v1",
)

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {"role": "system", "content": "你是一個嚴謹的中文助手。"},
        {"role": "user", "content": "用三句話介紹一下什麼是上下文緩存。"},
    ],
)

print(completion.choices[0].message.content)

4. 選模型

官方價格頁（2026-10-11 核對）列出的模型和價格，單位為元 / 百萬 token：

怎麼選：官方文檔把 kimi-k3 作為預設推薦；編程場景有專門的 kimi-k2.7-code 系列；對成本敏感的通用任務用 kimi-k2.6。價格可能調整，以官方價格頁為準。

K3 的推理強度通過請求頂層的 reasoning_effort 設定，可選 low、high、max，預設是 max。簡單任務記得調低，否則又慢又貴：

python
completion = client.chat.completions.create(
    model="kimi-k3",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "把這句話翻譯成英文：今天天氣不錯。"}],
)

5. 弄清計費規則

• 按 token 計費，輸入和輸出都收費；官方給的粗略換算是 1 個 token 約 1.5–2 個漢字；
• 緩存：命中緩存的輸入按「緩存命中」價格計，便宜一個數量級。K3 另有緩存寫入費用（按 5 分鐘和 1 小時兩檔）；
• 文件：上載文件並抽取出的內容作為輸入傳給模型時，按輸入計費；文件內容抽取和存儲目前限時免費；
• SDK 自動重試會多花錢：官方提醒 OpenAI SDK 預設對 408、409、429 和 5xx 自動重試 2 次，一次調用可能變成 2–3 次請求。

6. 了解限速

限速有並發、RPM（每分鐘請求數）、TPM（每分鐘 token 數）、TPD（每天 token 數）四個維度，任意一個先到就觸發。幾條官方規則：

• 限速等級和帳戶累計充值金額掛鉤，充得越多等級越高；各等級的具體數字在控制台查看；
• 限速按用戶計算而不是按 Key，所有模型共享；
• 網關判斷限速時用的是「請求 token 數 + max_completion_tokens」，而不是實際生成量。所以把 max_completion_tokens 設得過大，會更容易觸發限速。

常見問題

Q：返回 401 invalid_authentication_error？

官方的說法是通常 Key 用錯了平台：開放平台的 Key 和 Kimi Code 的 Key 不通用，國內站和國際站也互相隔離。核對 Key 的來源和 base_url 是否屬於同一個站點。

Q：返回 model_not_found？

多半是沒有設定 base_url，請求被髮到了 OpenAI 的伺服器。補上 base_url 即可。也可以用同一個 Key 調用 GET /v1/models 看看目標模型在不在列表裏。

Q：返回 429 怎麼辦？

先看錯誤類型，三種情況處理不同：

• engine_overloaded_error：服務節點負載高。按響應裏的 Retry-After 等待，降低並發、指數退避重試；充值不能解決這個問題；
• rate_limit_reached_error：觸發了你的限速。降低頻率，或通過充值提升等級；
• exceeded_current_quota_error：餘額不足、欠費或代金券失效，充值後重試。

Q：經常超時或連接斷開？

開啟流式輸出（stream=True），並檢查 SDK 和代理的超時設定，避免長時間沒有數據返回被網關斷開。

Q：Kimi 會員能當 API 用嗎？

不能。開放平台 API 是按量計費的獨立產品；會員額度用於 kimi.com 和 Kimi Code 等產品。

Q：客戶端沒收到結果，為什麼也扣費了？

官方說明客戶端沒顯示結果不代表請求失敗，服務端可能已經完成並計費。可以在控制台的用量看板和計費明細裏按 request_id 逐條核對。

Q：API 帳號能註銷嗎？

官方幫助中心寫的是不支持帳號註銷；手機號可以換綁，但新手機號不能註冊過開放平台或 Kimi 智能助手。

參考資料

• Kimi API 開放平台：快速開始 — https://platform.kimi.com/docs/intro
• Kimi API 開放平台：模型推理價格說明 — https://platform.kimi.com/docs/pricing/chat
• Kimi 幫助中心：API 帳號與認證 — https://www.kimi.com/help/kimi-api/api-account-and-auth
• Kimi 幫助中心：API 免費體驗（代金券）— https://www.kimi.com/help/kimi-api/api-free-trial
• Kimi 幫助中心：API 限速 — https://www.kimi.com/help/kimi-api/api-rate-limits
• Kimi 幫助中心：API 調用常見問題 — https://www.kimi.com/help/kimi-api/api-troubleshooting