思考力度 - Kimi API 开放平台

Kimi K3 始终进行推理，并通过顶层 reasoning_effort 配置 推理力度。当前唯一支持的值为 "max"。

K3 始终进行推理，并可能返回 reasoning_content；更多推理力度档位将在后续上线。

设置推理力度

在请求顶层设置 reasoning_effort：

{
  "model": "kimi-k3",
  "messages": [{"role": "user", "content": "请推导一下这个数列的通项公式：1, 4, 9, 25, 64, ..."}],
  "reasoning_effort": "max"
}

从 K2.x 迁移到 K3 时，将思考力度配置改为顶层 reasoning_effort: "max"。

curl
python

$ curl https://api.moonshot.cn/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $MOONSHOT_API_KEY" \
    -d '{
        "model": "kimi-k3",
        "messages": [
            {
                "role": "user",
                "content": "请推导一下这个数列的通项公式：1, 4, 9, 25, 64, ..."
            }
        ],
        "reasoning_effort": "max"
    }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.cn/v1",
)

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {"role": "user", "content": "请推导一下这个数列的通项公式：1, 4, 9, 25, 64, ..."},
    ],
    reasoning_effort="max",
)

message = completion.choices[0].message
if hasattr(message, "reasoning_content"):
    print(getattr(message, "reasoning_content"))
print(message.content)

用 reasoning_effort 兼容 OpenAI

如果你的代码已经使用 OpenAI 的 reasoning_effort 字段，无需改名；K3 当前仅接受 "max"。K3 的推理始终开启，可能返回 reasoning_content。

字段说明

字段	类型	必填	说明
`reasoning_effort`	string	否	K3 的顶层推理力度字段，当前唯一支持值为 `"max"`。

K3 的多轮对话和工具调用必须将 API 返回的完整 assistant message 原样回传到 messages，包括 reasoning_content 和 tool_calls。

注意事项

不同模型对 thinking 各子字段的支持与默认行为存在差异（例如 kimi-k2.6 不支持 thinking.effort，thinking.keep 默认不保留历史思考），详见模型参数参考；
后续上线的更低 effort 档位可减少 reasoning_content 的 token 消耗与响应延迟，适合分类、改写、简单问答等轻量任务；当前 max 为唯一可用档位。

当前切换 effort 档位不会影响前缀缓存命中。 思考力度当前仅支持 max 档位。待更多档位上线后，切换档位可能导致缓存失效，仍建议在会话开始前确定 effort 档位，避免中途切换。

​设置推理力度

​用 reasoning_effort 兼容 OpenAI

​字段说明

​注意事项

​相关阅读

设置推理力度

用 reasoning_effort 兼容 OpenAI

字段说明

注意事项

相关阅读