推理
三个接口各自按官方形态声明推理；档位之内的取值直接转发上游，档位之外的取值是「思考 key」，即一个原样透传的字符串，平台不解释它的含义。
按接口声明
| 参数 | 类型 | 约束 | 说明 |
|---|---|---|---|
reasoning_effort |
string | Chat Completions，非空 | 推理档位：minimal、low、medium、high、xhigh、max、none 直接转发；档位之外的非空值按思考 key 透传，不报枚举错误 |
thinking |
object | Messages | {"type": "enabled", "budget_tokens": N} 或 {"type": "disabled"}；type 必须非空；budget_tokens 只能搭 enabled，且必须是整数，违规分别返回 invalid_value 与 invalid_type |
output_config.effort |
string | Messages，非空 | 新一代推理控制面；与 thinking 互斥，同时声明按 mutually_exclusive 拒绝 |
reasoning.effort |
string | Responses，非空 | 推理档位；档位之外的取值同样是思考 key |
思考 key
当请求要表达的不只是「想多深」，而是「先做一次显式规划再作答」这类档位表达不了的要求时，把档位字段写成运营方约定的 key。key 是不透明字符串，平台除了非空不做任何校验，含义由声明它的思考阶段决定；key 原样到达服务端，不进入模型输出。使用哪些 key 由运营方提供，不在本文档范围。
推理消耗的 token 计入输出用量；门户的用量明细提供推理步数下钻，见用量与账单。