> ## Documentation Index
> Fetch the complete documentation index at: https://platform.kimi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 思考力度

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

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

## 设置推理力度

在请求顶层设置 `reasoning_effort`：

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

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

<Tabs>
  <Tab title="curl">
    ```bash theme={null}
    $ 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"
        }'
    ```
  </Tab>

  <Tab title="python">
    ```python theme={null}
    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)
    ```
  </Tab>
</Tabs>

## 用 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` 默认不保留历史思考），详见[模型参数参考](/api/models-overview)；
* 后续上线的更低 `effort` 档位可减少 `reasoning_content` 的 token 消耗与响应延迟，适合分类、改写、简单问答等轻量任务；当前 `max` 为唯一可用档位。

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

## 相关阅读

* [Kimi K3 API 工具调用最佳实践](/guide/kimi-k3-tool-calling-best-practice)：思考力度在工具调用场景中的取舍
* [使用思考模式](/guide/use-kimi-k2-thinking-model)：各模型的思考行为与保留式思考（Preserved Thinking）
* [模型参数参考](/api/models-overview)：各模型的参数配置差异