TiDBA API

Responses API 是 200,但为什么没有文字?

先不要把空的 output_text 等同于失败:模型可能正在请求工具,也可能因输出上限而结束,或者客户端只读取了错误字段。

更新于 2026-10-08阅读约 4 分钟

先看完整 Response 的四个字段

jq '{status, incomplete_details, usage,
     output_types: [.output[]?.type]}' response.json
  1. status=completed 且 output 含 function_call:需要客户端执行工具并提交工具结果,不能只读取文本。
  2. status=incomplete 且原因是 max_output_tokens:输出预算可能先被推理或结构化内容消耗,需重新评估上限与任务复杂度。
  3. 有 message 却没有显示:检查客户端解析是否只读了 choices[0].message;这是 Chat Completions 的形状,不是 Responses 的通用形状。
  4. 流式请求只有 delta、没有结束事件:先按 流式中断 排查。

为什么输出 token 多于可见文字?

OpenAI 的输出 token 统计还可能包含推理、工具调用与不可见的格式 token。max_output_tokens 限制的是模型生成的全部 token,而不只是屏幕上看到的字。因此只给很小的输出预算,可能得到很少甚至没有可见文字。

不要反复盲目增大预算。先看 usage.output_tokens_details.reasoning_tokens、输出项类型与任务是否需要工具。若输入本身过大,请看 上下文超限。

官方依据

OpenAI 官方文档:Counting tokens 与 Responses streaming events。

保存响应状态

排障时提供 status、reason 和 Request ID,不必公开完整提示词。

了解工具调用