跳到正文
HopBase 文檔
登入控制台

Kimi K3

通過 OpenAI Chat Completions 兼容協議接入 Kimi K3，含 Claude Code 與 Codex CLI 經 CC Switch 路由的配置步驟。

Kimi K3 走 HopBase 的 OpenAI Chat Completions 兼容協議。接入時統一使用 https://api.hop-base.com/v1，模型名填寫 kimi-k3。

Kimi K3 是月之暗面（Moonshot AI）最新的旗艦模型：1M 上下文（1,048,576 tokens），單次最大輸出 32,768 tokens，可讀文字與圖片（圖片僅支援 base64）。

分組與計費

  • 在控制台「API 金鑰」新建或編輯金鑰時，把 Kimi K3 雲廠商 分組加進金鑰，該 Key 即可調用 kimi-k3。
  • 你的實際單價以登入後的模型廣場為準。
  • 不含本分組的 Key 調用 kimi-k3 會收到明確的 404 提示，在控制台把本分組加進 Key 即可。

客戶端字段

字段填寫值
API 地址 / Base URLhttps://api.hop-base.com/v1
API Keysk-你的密鑰
模型kimi-k3
API 格式OpenAI Chat Completions（CC Switch 等支援路由的客戶端裡選 OpenAI Chat Completions（需開啟路由））
上下文窗口1,048,576 tokens
單次最大輸出32,768 tokens

各客戶端支援情況

Kimi K3 只提供 POST /v1/chat/completions。/v1/responses 與 /v1/messages 對該模型都會返回 404，因此只會說 OpenAI Responses 協議或 Anthropic Messages 協議的客戶端，需要一層協議轉換才能使用。

客戶端原生協議接入方式
OpenAI SDK、curl、LobeChat、Dify、Cherry Studio 等Chat Completions直接填 Base URL、Key 與模型名，見下文範例
Claude CodeAnthropic Messages經 CC Switch 本地路由轉換，見下文步驟
Codex CLIOpenAI Responses經 CC Switch 本地路由轉換，見下文步驟
Codex CLI 不要手改 config.toml：

Codex CLI 自 0.122 起已移除 wire_api = "chat"，啟動即報 wire_api = "chat" is no longer supported；而 wire_api = "responses" 會打到 /v1/responses 返回 404。兩條路都走不通，必須經 CC Switch 路由。

請求參數

以下為 2026-10-10 經生產網關逐參數實測。網關攔截空 messages，並移除下表標為「接受但忽略」的參數；其餘限制都來自模型服務。

參數必填類型與限制預設值說明
model必填kimi-k3—精確匹配
messages必填非空陣列，文字與 base64 圖片—缺失或空陣列由網關直接返回 400；圖片見下方說明
max_tokens選填整數 1–32,768服務預設小於 1 返回 400 Input should be greater than or equal to 1；超過 32,768 返回 422 max_completion_tokens=… exceeds the limit of 32768
temperature選填數值 0–1服務預設大於 1 返回 400。用它控制隨機性
top_p選填接受但忽略—請求到達模型前被移除；請改用 temperature
n選填僅 11大於 1 返回 400
frequency_penalty、presence_penalty選填接受但忽略—請求到達模型前被移除
seed、stop選填同 OpenAI—實測可用。logprobs 可傳，但不會返回對數機率
response_format選填json_object / json_schema（含 strict）純文字
tools、tool_choice、parallel_tool_calls選填同 OpenAI；tool_choice 可為 auto / required / 指定函式auto支援 $ref / $defs / anyOf 深層 schema
stream選填布林false
stream_options.include_usage選填布林false串流下要在最後一個分片拿到 usage 必須設 true
thinking、reasoning_effort選填接受但不生效—模型不返回思考，見下文
圖片只支援 base64 data URL：

在 image_url 裡以 data:image/...;base64, 形式傳圖。公網圖片連結（https://...）會返回 400，報錯只提示檢查請求參數，請先下載並編碼成 base64 再傳送。

用 CC Switch 在 Claude Code 中啟用 Kimi K3

請使用 CC Switch 3.17.0 或更高版本（建議直接安裝最新版）。Kimi K3 使用 OpenAI Chat Completions，必須由 CC Switch 的本地路由轉換成 Claude Code 使用的 Anthropic Messages 協議。

新建 HopBase Kimi 供應商

打開 CC Switch，切到頂部的 Claude Code 頁簽，點右上角 +，選擇「自訂設定」。填寫：

  • 供應商名稱：HopBase Kimi K3
  • API Key：你的 sk- 密鑰
  • 請求地址：https://api.hop-base.com/v1（末尾不要加斜線）

設定格式和模型映射

展開「進階選項」，按下面設定後儲存：

  • 格式（舊版本叫「API 格式」）：OpenAI Chat Completions（需開啟路由）
  • 驗證欄位：保持預設的 ANTHROPIC_AUTH_TOKEN
  • 備用模型（預設兜底模型）：kimi-k3
  • 模型對應：把 Sonnet、Opus、Fable、Haiku 各檔位都填成 kimi-k3，主對話和背景子任務就都固定走 K3

儲存後，供應商卡片會顯示「需要路由」。

開啟本地路由

進入 設定 → 路由 → 本地路由，先打開「路由總開關」，再在「路由啟用」中打開 Claude Code。首次開啟會彈出說明，確認後保持 CC Switch 在背景執行。

啟用並驗證

回到 Claude Code 供應商列表，在 HopBase Kimi K3 卡片上點「啟用」。首次開啟路由接管後，關閉目前終端機並重新打開，執行 claude，傳送一個簡短問題。

再回到 設定 → 路由：如果「目前 Provider」顯示 HopBase Kimi K3 且請求數增加，說明配置已生效。路由執行期間切換供應商是熱切換，無需再次重啟終端機。

用 CC Switch 在 Codex CLI 中啟用 Kimi K3

同樣需要 CC Switch 3.17.0 或更高版本。CC Switch 會讓 Codex 繼續以 Responses 協議連本機路由（預設 127.0.0.1:15721），由路由把請求改寫成 Chat Completions 發給 HopBase，再把響應轉回 Responses 形態。

新建 Codex 供應商

切到頂部的 Codex 頁簽，點右上角 +，選擇「自訂設定」。填寫：

  • 供應商名稱：HopBase Kimi K3
  • API Key：你的 sk- 密鑰
  • 請求地址：https://api.hop-base.com/v1（服務根地址，不要帶 /chat/completions）

設定格式與模型

展開「進階選項」，按下面設定後儲存：

  • 格式：Chat Completions（需開啟路由）
  • 模型名稱：kimi-k3
  • 預設模型：kimi-k3
  • 模型映射：加一行 kimi-k3，Codex 的 /model 選單才會列出它
  • 「支援思考模式」「支援思考等級」保持關閉：Kimi K3 目前不返回思考內容（見下文）

儲存後卡片顯示「需要路由」。CC Switch 會把 ~/.codex/config.toml 指向 http://127.0.0.1:15721/v1 並保持 wire_api = "responses"，真實密鑰留在 CC Switch 內由路由轉發時注入。

開啟路由並接管 Codex

進入 設定 → 路由 → 本地路由，打開「路由總開關」，再在「路由啟用」中打開 Codex。

啟用並驗證

回到 Codex 供應商列表，在 HopBase Kimi K3 卡片上點「啟用」，然後關閉並重新打開終端機，執行 codex。用 /model 確認目前模型是 kimi-k3，傳送一個簡短問題，再回到 設定 → 路由 看請求數是否增長。

思考輸出、前綴緩存與工具調用

以下為 HopBase 2026-10 經生產網關的實測結論：

  • 目前不返回思考過程：響應裡沒有 reasoning_content 字段，usage.completion_tokens_details.reasoning_tokens 恆為 0，輸出 token 全部是正文。請求裡帶 thinking 或 reasoning_effort 不會報錯，但也不會生效。max_tokens 無需為思考預留，按正文長度設定即可（上限 32,768）。
  • 長上下文可用且能精確檢索：實測約 47 萬 token 的單次輸入正常返回，埋在其中的關鍵資訊被準確取出。
  • 前綴緩存整段命中：相同前綴再次請求時，usage.prompt_tokens_details.cached_tokens 等於命中的前綴長度（例如 2,093 token 的 system 提示，第二次調用即 2,093 全部命中），按緩存價計費。把系統提示、工具定義等固定內容放在消息列表最前面即可穩定複用。
  • 工具調用可用：tools、tool_choice（含 required）、parallel_tool_calls、帶 $ref 與 $defs 的 JSON Schema、多輪 tool 消息回填，流式與非流式均正常。
  • 回應速度參考：10 分鐘持續壓測中首字中位數約 1.7 秒；非串流輸出 9,000 token 約 78 秒返回。客戶端建議保留重試，讀取逾時設為 300 秒以上。

OpenAI SDK / Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.hop-base.com/v1",
    api_key="sk-你的密鑰",
)

resp = client.chat.completions.create(
    model="kimi-k3",
    max_tokens=4096,
    messages=[{"role": "user", "content": "解釋一下 Kimi K3 的適用場景"}],
)
print(resp.choices[0].message.content)
print(resp.usage)

curl

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

常見問題

  • /v1/responses 或 /v1/messages 返回 404：該模型只有 /v1/chat/completions。Codex CLI 和 Claude Code 請按上文經 CC Switch 路由，不要把 HopBase 地址直接填進 ~/.codex/config.toml 或 ANTHROPIC_BASE_URL。
  • Codex 啟動報 wire_api = "chat" is no longer supported：新版 Codex 不再支援 Chat 直連，刪掉手寫的 provider 配置，改用 CC Switch 接管。
  • 調用 kimi-k3 返回 404 model not found：目前 Key 不含「Kimi K3 雲廠商」分組，把該分組加進 Key 或新建 Key。
  • Codex 的 /model 看不到 kimi-k3：模型映射儲存後需要重啟 Codex 才會重新整理選單。
  • 返回 400 且只說「請檢查請求參數」：優先排查 temperature 大於 1、n 大於 1，或圖片用了公網連結而不是 base64。
  • 返回 429 並發已達上限：這是你帳號的並發限制（預設 5），跑並發壓力測試或多路 agent 前請聯繫我們調高。

下一步

本頁目錄

分組與計費客戶端字段各客戶端支援情況請求參數用 CC Switch 在 Claude Code 中啟用 Kimi K3新建 HopBase Kimi 供應商設定格式和模型映射開啟本地路由啟用並驗證用 CC Switch 在 Codex CLI 中啟用 Kimi K3新建 Codex 供應商設定格式與模型開啟路由並接管 Codex啟用並驗證思考輸出、前綴緩存與工具調用OpenAI SDK / Pythoncurl常見問題下一步