跳到正文
上新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 文档。