Kimi Code 文档

简体中文

English

简体中文

English

Appearance

模型配置 ​

本页介绍 Kimi Code 提供的模型、各客户端的切换方式、第三方工具接入和常见调用问题。

模型总览 ​

Kimi Code 目前提供 6 个模型，覆盖 K3.1 Pro（及高速版）、K3（及 256K 上下文版）、K2.8 Preview 和 K2.7 Code Highspeed。无论是在官方客户端还是第三方工具中，都按模型 ID 选择具体版本。各版本的规格与套餐要求如下。

K3.1 Pro 系列模型 全新上线

K3.1 Pro 现已全量上线 Kimi Code，这是全新 K3.1 系列的第一个模型，这是我们迄今能力最强的三万亿级参数模型，支持 100 万上下文，在代码、3D 创作、金融研究和其他长程 Agent 能力上的提升尤为显著。更多技术细节见 技术报告。

我们还同步推出了 Kimi K3.1 Pro Highspeed，在相同的模型效果下，其速度是 K3.1 Pro 的约 2–3 倍，具有更快的交互响应。

使用建议

  • 保持思考开启：K3.1 Pro 系列仅支持思考模式，关闭思考的请求会被拒绝。
  • 新建会话后再使用：建议不要在 K3 系列、K2.8 Preview、K2.7 Code Highspeed 的历史会话中切换模型至新模型，会导致模型效果异常，同时也会降低缓存命中，请创建新的会话体验 K3.1 Pro 系列模型。
  • 使用原生接口协议：K3.1 Pro 系列模型推荐使用 kimi coding plan 原生 Responses、chat completion、message 接口协议调用，以获得最佳的效果稳定性，使用代理工具进行协议转换后可能引起效果波动。
Model IDk3.1-prok3.1-pro-highspeedk3k3-256kkimi-for-codingkimi-for-coding-highspeed
模型版本K3.1 ProK3.1 Pro HighspeedK3K3K2.8 PreviewK2.7 Code Highspeed
说明Kimi 最新一代旗舰模型，3T级别参数模型，1M 上下文窗口，仅支持思考模式K3.1 Pro 的高速版，模型能力一致，输出速度更快、消耗约为普速版两倍上一代旗舰模型，2.8T 参数规模，1M 上下文窗口K3 的 256K 上下文版本，k3（1M）消耗约为 k3-256k 两倍综合性能接近 K3，思考效率更高，擅长代码补全与常规开发任务K2.7 Code 的高速版，编码能力一致，输出速度约为普通版 5–6 倍
速度常规速度高速版（约 2–3 倍速，2 倍消耗）常规速度常规速度常规速度高速版（约 6 倍速，3 倍消耗）
上下文窗口最高 1048576（面向高档位会员）最高 1048576（面向高档位会员）最高 1048576（面向高档位会员）最高 262144最高 1048576最高 262144
思考程度reasoning_effort:low / high / max
（默认 high，不支持关闭思考）		reasoning_effort:low / high / max
（默认 high，不支持关闭思考）		reasoning_effort:low / high / max
（默认 high）		reasoning_effort:low / high / max（默认 high）reasoning_effort:low / high / max
（默认 max）		Thinking:ON
调用限制（新套餐）Plus 及以上可用
Pro 及以上支持 1M 上下文		Pro 及以上可用Plus 及以上可用
Pro 及以上支持 1M 上下文		Plus 及以上可用Plus 及以上可用Pro 及以上
调用限制（老套餐）Moderato 及以上可用
Allegretto 及以上支持 1M 上下文		Allegretto 及以上可用Moderato 及以上可用
Allegretto 及以上支持 1M 上下文		Moderato 及以上可用Andante 及以上可用Allegretto 及以上
多模态输入支持图片、视频图片、视频图片、视频仅图片图片、视频图片、视频

想了解或升级会员套餐？

不同会员套餐解锁不同的模型、上下文与速度能力，可前往 会员订阅 →。

如何切换模型 ​

切换前须知

  • 建议新建会话：在历史会话中切换模型会使已有上下文缓存失效，需要重新预填充并增加 token 消耗；不同模型的思维链也可能相互影响。
  • 第三方调用应正确填写模型 ID：请使用上表中的 k3.1-pro、k3.1-pro-highspeed 等模型 ID，不要填写 K3.1 Pro、K3.1 Pro Highspeed 等模型版本名，模型 id 填写错误会兜底到 K2.8 Preview 的无思考版本。
  • 确认思考模式：K3.1 Pro 系列仅支持思考模式，关闭思考的请求会被拒绝；K3 系列、K2.8 Preview 和 K2.7 Code Highspeed 关闭思考后都会路由到 K2.8 Preview 无思考版；K2.7 Code Highspeed 不支持调整思考程度。第三方工具的取值映射见 思考程度映射与路由规则。

官方客户端 ​

  • Kimi Code 桌面端：在输入框内的模型选择器切换目标模型；若目标模型还没出现，重启桌面端或重新登录即可。
  • 官方 Kimi Code CLI：输入 /model 即可切换模型，无需修改配置；列表里暂未出现最新模型时，/logout 后重新 /login 即可。
  • Kimi Code for VS Code：在输入栏下拉菜单中选择目标模型；若目标模型还没出现，重启 VS Code 或重新安装插件即可。

尚未安装客户端时，可前往 Kimi Code 主页 下载桌面端、命令行或 VS Code 插件。

第三方工具 ​

  1. 在 Kimi Code 控制台 创建 API Key。
  2. 在工具中填入 Base URL 和目标模型 ID。

Kimi Code API 支持 OpenAI（Responses / Chat Completions）和 Anthropic 协议。支持 Responses API 的工具应优先使用原生 Responses 格式，Base URL 如下：

协议Base URL
OpenAI
（Responses / Chat Completions）		国内 https://api.kimi.com/coding/v1
海外 https://api.kimi.ai/coding/v1
Anthropic 兼容国内 https://api.kimi.com/coding/
海外 https://api.kimi.ai/coding/

详细配置步骤请参考对应工具的接入文档：

Claude CodeAnthropic 的命令行编程助手OpenCode终端编程 AgentCodexOpenAI 的编程 Agent

思考程度映射与路由规则 ​

K3.1 Pro 系列、K3 系列和 K2.8 Preview 支持 low / high / max 三档思考程度。第三方工具传入的 effort 按下表映射；K2.7 Code Highspeed 不支持调整思考程度。

工具传入值实际思考程度或处理行为
未传 effort（null / undefined）使用模型默认值：K3.1 Pro 系列和 K3 系列为 high，K2.8 Preview 为 max
ultra / max / xhighmax
high / mediumhigh
low / minimum / lightlow
off / none / disabledK3.1 Pro 系列：关闭思考的请求会被拒绝（HTTP 400）
K3 系列、K2.8 Preview 与 K2.7 Code Highspeed：关闭 thinking 后，请求均由 K2.8 Preview（无思考）处理
其他未知取值返回 HTTP 400

切换思考程度也会使上下文缓存失效。建议在同一会话中保持档位一致；确需切换时，新建会话以避免重复预填充和额外的 token 消耗。

常见问题 ​

模型 ID 填写正确但返回 403、400

模型 ID 正确只表示模型标识有效，请求能否成功还取决于账号权限、思考模式和上下文上限。按报错信息区分：

  • 账号没有模型或 1M 上下文权限（403）：当前套餐不包含所需能力。可以回到 模型规格表 核对调用限制，再按需前往 会员订阅升级套餐。
  • 关闭思考（400）：K3.1 Pro 系列仅支持思考模式，必须保持思考开启；传入 none 或 disabled 会被拒绝。
  • 使用的模型不支持 1M 或请求超出上下文上限（400）：部分模型如 k3-256k、kimi-for-coding-highspeed，不支持 1M 上下文，可参照 模型规格表 了解详情，或切换到支持最高 1M 的模型和档位，上下文过长时先 compact。
如何保持模型效果并减少消耗？

尽量在一个会话中固定模型和思考程度，不要来回切换。切换模型或思考程度会使已有上下文缓存失效，需要重新预填充并增加 token 消耗；不同模型的思维链还可能相互影响。

为什么高速版提速不明显？

两个常见原因：

  • 模型 ID 填错：高速版 ID 必须是 k3.1-pro-highspeed 或 kimi-for-coding-highspeed，填错会兜底到无思考版 K2.8 Preview，不会加速。
  • 工具与脚本占了大头：高速版只加快模型输出；一次任务里工具调用（读写文件、执行命令等）与脚本执行的耗时不受影响，这部分占比大时整体提速就不明显。
K3（1M）与 K3-256k 切换注意事项

K3（1M）切换至 K3-256k：如果当前会话的上下文已超过 256k，部分 coding 工具（如 Kimi Code CLI、Claude Code）会在工具侧直接执行 compact。建议：

  1. 切换前先手动执行一次 compact，将上下文压缩至 256k 以内，既能保留任务要点、会话不断档，切换后额度也更耐用。
  2. 若历史上下文中包含视频文件，由于 K3-256k 不支持视频输入，直接切换会报错，请先 compact 再切换。

K3-256k 切换至 K3（1M）：如果 K3-256k 已接近 256k 上限且不希望 compact 丢失信息，可以直接切换到 1M；当前版本从 256k 切换到 1M 不会影响缓存。