Kimi K3

Kimi K3 走 HopBase 的 OpenAI Chat Completions 兼容协议。接入时统一使用 https://api.hop-base.com/v1，模型名填写 kimi-k3。

分组与计费

• 在控制台「API 密钥」新建或编辑密钥时，把 Kimi K3 云厂商 分组加进密钥，该 Key 即可调用 kimi-k3。
• 你的实际单价以登录后的模型广场为准。
• 不含本分组的 Key 调用 kimi-k3 会收到明确的 404 提示，在控制台把本分组加进 Key 即可。

客户端字段

各客户端支持情况

Kimi K3 只提供 POST /v1/chat/completions。/v1/responses 与 /v1/messages 对该模型都会返回 404，因此只会说 OpenAI Responses 协议或 Anthropic Messages 协议的客户端，需要一层协议转换才能使用。

请求参数

以下为 2026-10-10 经生产网关逐参数实测。网关拦截空 messages，并移除下表标为「接受但忽略」的参数；其余限制都来自模型服务。

用 CC Switch 在 Claude Code 中启用 Kimi K3

请使用 CC Switch 3.17.0 或更高版本（建议直接安装最新版）。Kimi K3 使用 OpenAI Chat Completions，必须由 CC Switch 的本地路由转换成 Claude Code 使用的 Anthropic Messages 协议。

用 CC Switch 在 Codex CLI 中启用 Kimi K3

同样需要 CC Switch 3.17.0 或更高版本。CC Switch 会让 Codex 继续以 Responses 协议连本机路由（默认 127.0.0.1:15721），由路由把请求改写成 Chat Completions 发给 HopBase，再把响应转回 Responses 形态。

思考输出、前缀缓存与工具调用

以下为 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 前请联系我们调高。

下一步

• OpenAI SDK——Chat Completions 通用写法
• CC Switch——本地路由的安装与排错
• 错误码与重试
• 并发、超时与计费