Responses API 是 200,但为什么没有文字?
先不要把空的 output_text 等同于失败:模型可能正在请求工具,也可能因输出上限而结束,或者客户端只读取了错误字段。
先看完整 Response 的四个字段
jq '{status, incomplete_details, usage,
output_types: [.output[]?.type]}' response.jsonstatus=completed且output含function_call:需要客户端执行工具并提交工具结果,不能只读取文本。status=incomplete且原因是max_output_tokens:输出预算可能先被推理或结构化内容消耗,需重新评估上限与任务复杂度。- 有
message却没有显示:检查客户端解析是否只读了choices[0].message;这是 Chat Completions 的形状,不是 Responses 的通用形状。 - 流式请求只有 delta、没有结束事件:先按 流式中断 排查。
为什么输出 token 多于可见文字?
OpenAI 的输出 token 统计还可能包含推理、工具调用与不可见的格式 token。max_output_tokens 限制的是模型生成的全部 token,而不只是屏幕上看到的字。因此只给很小的输出预算,可能得到很少甚至没有可见文字。
不要反复盲目增大预算。先看 usage.output_tokens_details.reasoning_tokens、输出项类型与任务是否需要工具。若输入本身过大,请看 上下文超限。
官方依据
保存响应状态
排障时提供 status、reason 和 Request ID,不必公开完整提示词。