跳至正文
上新GPT-6.2 已上線:Astra / Sol 雙型號,1.05M 上下文,每百萬 token $2 / $10 起查看價格
HopBase
← 返回博客

Kimi K3.1 Pro API 呼叫指南:$2/$10,1M 上下文,Claude Code 直連

Kimi K3.1 Pro API 呼叫指南:$2/$10,1M 上下文,Claude Code 直連

月之暗面(Moonshot AI)的 Kimi K3.1 Pro(模型 ID kimi-k3.1-pro)已在 HopBase 上線。它同時支援 OpenAI 相容的 POST /v1/chat/completions、POST /v1/responses 與 Anthropic 相容的 POST /v1/messages,OpenAI SDK、Anthropic SDK、Claude Code 和 Codex CLI 都能直連。它是 Kimi K3 系列的最新旗艦:1M 上下文(1,048,576 tokens),單次最大輸出 131,072 tokens,預設深度思考、思考過程在 reasoning_content 回傳,可讀取文字與圖片,支援工具呼叫與自動前綴快取。HopBase 按月之暗面官方牌價計費:每百萬輸入 $2、快取讀取 $0.20、輸出 $10,比 Kimi K3 低約三分之一。密鑰所在分組包含它即可呼叫,用 GET /v1/models 查看目前密鑰能呼叫哪些模型。

2026-11-17 更新:價格已與月之暗面官方定價頁核對;規格與行為均在 HopBase 正式環境閘道實測。

三分鐘跑通:註冊 HopBase 控制台並建立密鑰,把「Kimi K3 系列 自部署」分組加進密鑰,Base URL 填 https://api.hop-base.com/v1、模型填 kimi-k3.1-pro,下面的 curl 直接可用。

怎麼呼叫

  • 三種協定,一把密鑰:POST /v1/chat/completions 與 POST /v1/responses 的 Base URL 是 https://api.hop-base.com/v1;Anthropic SDK 與 Claude Code 走 POST /v1/messages,Base URL 是 https://api.hop-base.com(不帶 /v1)。
  • 使用完整模型 ID:kimi-k3.1-pro,以 GET /v1/models 回傳為準。
  • 開通:該模型在「Kimi K3 系列 自部署」分組,同組也提供 kimi-k3。GET /v1/models 裡看不到 kimi-k3.1-pro 時,在控制台把該分組加進密鑰即可。
  • 思考單獨回傳:思考過程在 reasoning_content(Messages 協定為 thinking 區塊),與正文分開。

價格:按官方牌價

每百萬 tokensKimi K3Kimi K3.1 Pro
輸入$3.00$2.00
快取讀取$0.30$0.20
輸出$15.00$10.00

以上為月之暗面公布的官方牌價,不按上下文長度分級。扣費 = 牌價 × 實際用量,控制台逐筆可查,實際單價取決於你所在的分組。思考 token 按輸出價計費。快取讀取只要輸入價的十分之一,反覆帶同一段前綴的 Agent 迴圈和長對話最省。企業批量價請在價格頁聯絡業務。

規格與實測

  • 上下文與輸出:1,048,576 tokens 上下文,單次最多輸出 131,072 tokens;實測單次輸出 40,000 tokens 正常完成。
  • 長上下文能精確檢索:約 90 萬 tokens 的單次輸入,埋在 60% 深度的關鍵資訊被準確取出。
  • 前綴快取自動生效:2.5 萬 tokens 的前綴第二次起約 99% 命中,命中量在 usage.prompt_tokens_details.cached_tokens。
  • 圖片:以 base64 data: URL 傳入;公開網路圖片連結回傳 400。
  • 工具呼叫:tools、tool_choice(auto / required / none)、平行呼叫、深層 JSON Schema、多輪工具結果回填,串流與非串流、三種協定均正常。
  • 思考比 K3 精簡:同樣的問題,K3.1 Pro 的思考 token 通常少很多,回應也更快;持續壓測中首字中位數約 2.3 秒。

參數建議

  • 模型按固定溫度取樣。temperature、top_p、frequency_penalty、presence_penalty 接受但忽略,帶取樣滑桿的用戶端照常可用。
  • n 只能為 1。
  • 模型思考時不能用 tool_choice 強制指定某個函式(回傳 400);要求它必須呼叫工具時用 "required"。
  • max_tokens 包含思考,請預留餘量。長輸出建議用串流,並加 stream_options: {"include_usage": true} 在最後一個分片取得用量。

三分鐘串接

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3.1-pro",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "用三句話介紹一下你自己"}]
  }'

Claude Code 經 Anthropic Messages 直連:

export ANTHROPIC_BASE_URL="https://api.hop-base.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密鑰"
export ANTHROPIC_MODEL="kimi-k3.1-pro"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000
claude

Codex CLI 設定、完整參數表與常見問題見 Kimi K3 / K3.1 Pro 串接文件。

常見問題

怎麼呼叫 Kimi K3.1 Pro?

向 POST https://api.hop-base.com/v1/chat/completions 發送 OpenAI 相容請求,模型 ID 填 kimi-k3.1-pro。現有 OpenAI SDK 只需改 Base URL、密鑰和模型名稱。/v1/responses 與 Anthropic 相容的 /v1/messages 也可用。密鑰需要包含「Kimi K3 系列 自部署」分組。

Kimi K3.1 Pro 多少錢?

按月之暗面官方牌價計費:每百萬輸入 $2、快取讀取 $0.20、輸出 $10,比 Kimi K3 的 $3 / $0.30 / $15 低約三分之一。扣費 = 牌價 × 實際用量,實際單價取決於你所在的分組。

能在 Claude Code 或 Codex CLI 裡用嗎?

能,直連即可。Claude Code 走 /v1/messages,Base URL 填 https://api.hop-base.com;Codex CLI 走 /v1/responses,wire_api = "responses",Base URL 填 https://api.hop-base.com/v1。不需要本機協定路由。

選 Kimi K3.1 Pro 還是 Kimi K3?

兩者都是 1M 上下文。K3.1 Pro 每一級都更便宜、思考更精簡、單次輸出更長(131,072 對 32,768 tokens),新業務建議從它開始。兩個模型在同一個分組,一把密鑰都能呼叫,可以用自己的提示詞對比。

呼叫 kimi-k3.1-pro 回傳 404 怎麼辦?

404 model_not_found 表示密鑰的分組裡沒有這個模型。在控制台把「Kimi K3 系列 自部署」分組加進密鑰,並確認 ID 拼寫完整:kimi-k3.1-pro。

能看圖嗎?

能,在 image_url 裡以 base64 data:image/...;base64, 形式傳圖。公開網路 https:// 圖片連結回傳 400,請先下載並編碼。

開始呼叫:註冊 HopBase 控制台並建立密鑰;完整參數見 Kimi K3 / K3.1 Pro 文件。