Kimi 参数与协议差异
了解 Kimi 系列模型在兼容协议下的参数差异与使用方式。
使用 Kimi 模型时，根据本页调整所选协议的参数。完整请求和响应结构参阅 Chat Completions、Responses 和 Messages。
| 模型 | 适用范围 |
|---|
| kimi-k3.1-pro、kimi-k3.1-pro-highspeed、kimi-k3 | 下列三种协议的共同参数规则；专项扩展的适用模型在对应行注明 |
| 字段 | 差异说明 |
|---|
temperature、top_p | 分别固定为 1.0、0.95；建议省略，传入其他值会报错 |
n、presence_penalty、frequency_penalty | 分别固定为 1、0、0，传入其他值会报错 |
reasoning_effort | 支持 low/high/max，默认 max；始终开启思考和保留式思考，不使用 K2.x 的 thinking 开关 |
max_completion_tokens | 默认 131072，最大 1048576；输入与输出预算之和超过上下文窗口时，会自动缩减输出预算，输入本身仍须在窗口内 |
stop | 最多 5 个字符串，每个不超过 32 字节 |
tool_choice | 支持 auto/none/required；指定函数的对象形式与思考开启不兼容，传入会返回 400 |
messages[].reasoning_content | 多轮及工具调用须原样回传完整 assistant 消息，包括思考内容和 tool_calls |
messages[].partial | Kimi Partial Mode 扩展：末条 assistant 消息设为 true，从已给出的前缀继续生成；不要与 response_format.type=json_object 混用 |
messages[].tools | 动态工具扩展，官方指南列出 kimi-k3.1-pro、kimi-k3：追加一条含完整工具定义的 system 消息，且不能包含 content；工具从该位置起可见，后续请求须保留这条消息 |
| 字段 | 差异说明 |
|---|
reasoning.effort | 支持 low/high/max，默认 max |
max_output_tokens | 默认 131072，最大 1048576 |
tool_choice | 仅支持 auto |
tools[].type | 仅支持 function/namespace/custom/web_search；custom 工具的名称仅接受 apply_patch |
text.format | 使用 type: "json_schema" 和 schema；name 省略时为 output |
| 响应中的会话状态字段 | store、background 固定为 false，previous_response_id、conversation 固定为 null；多轮由客户端回传历史输入和输出，不依赖服务端保存响应链 |
| 字段 | 差异说明 |
|---|
max_tokens | 必填，最小值为 1，不能使用 0 |
output_config.effort | 支持 low/high/max，默认 max |
tool_choice.type | 支持 auto/any/none，默认 auto |
stop_sequences | 最多 5 个字符串，每个不超过 32 字节 |
历史 thinking 块 | 连同 signature 原样放回下一轮 assistant 消息中 |
output_config.format | 结构化输出须填写 type: "json_schema" 和 schema |
| 字段 | 差异说明 |
|---|
Chat／Responses 的 prompt_cache_options | mode 仅支持 implicit；ttl 支持 5m/1h，默认 5m；未传配置时仍默认写入 5 分钟缓存 |
Chat／Responses 的 prompt_cache_breakpoint | 不支持显式断点；在内容中传入会返回 400 |
Messages 的 cache_control | 仅请求顶层配置生效，messages 内的标记被忽略；type 固定为 ephemeral，ttl 支持 5m/1h，默认 5m；不传时仍按 5 分钟 TTL 读写缓存 |
| 推理强度 | 切换档位会破坏前缀缓存命中，建议在会话开始前确定 |
ms:// 是 Kimi 原厂文件引用格式，需先在原厂上传文件；本页不提供 AGTCloud 文件上传接口。
将 MODEL_ID 替换为所选协议入口可用的完整模型 ID，API Key 使用自己的值。
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "用三点说明如何排查接口超时"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096,
"prompt_cache_options": {"mode": "implicit", "ttl": "1h"}
}'