GPT 推理设置

本页说明 GPT 系列的推理强度、推理摘要与回答长度控制；模型 ID 与接口配置见 GPT 系列概览。

要点推理消耗的 token 计入输出上限。开启推理时请预留足够的 max_completion_tokens，否则回答可能为空。

GPT-5 及之后的模型支持推理：先进行内部推理，再给出回答，适合数学、代码与多步骤分析。

项目	Chat Completions	Responses
推理强度	`"reasoning_effort": "high"`	`"reasoning": {"effort": "high"}`
推理 token 数	`usage.completion_tokens_details.reasoning_tokens`	`usage.output_tokens_details.reasoning_tokens`
推理内容	不返回	推理摘要，见下文

常用取值为 low、medium、high，强度越高，推理 token 越多、耗时越长。传入模型不支持的值时返回 400，报错信息会列出该模型支持的取值。
未传入 reasoning_effort 时，各模型的默认行为不同：例如 GPT-5.4、GPT-6 Sol 默认不推理，GPT-5 默认推理。需要推理时请显式传入。
推理 token 按输出单价计费，并计入 max_completion_tokens（Responses 为 max_output_tokens）。

推理摘要

Responses 接口可返回推理过程的摘要，Chat Completions 不返回推理内容：

gpt_reasoning_summary.py


import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.responses.create(
    model="openai/gpt-5.4",
    reasoning={"effort": "medium", "summary": "auto"},
    max_output_tokens=20000,
    input="找出所有小于 50 的正整数 n，使 n² + n + 41 不是质数，并简要说明理由。",
)
for item in resp.output:
    if item.type == "reasoning":
        for s in item.summary:
            print("[推理摘要]", s.text)
print("[回答]", resp.output_text)

output 中可能包含多个 reasoning 条目，其中部分条目的 summary 为空数组，读取时请逐项判断。推理较少时可能没有摘要。

控制回答长度

GPT-5 系列模型在 Chat Completions 中支持 verbosity，取值为 low、medium、high，用于控制回答的详略程度。它与 max_completion_tokens 不同，不会截断回答。

其他报错见常见报错。