Skip to main content
非流式请求返回 object: "response" 的响应对象。Responses 的 output 是异构 item 数组,可能包含 assistant 消息、reasoning、函数调用或平台工具调用;不要假设首个 item 就是最终文本。

顶层字段

idobject 与时间字段

id 是当前响应的唯一标识,可用于 previous_response_id 延续对话。object 固定为 responsecreated_atcompleted_at 分别是创建与完成时的 Unix 秒级时间戳。

statuserrorincomplete_details

status 表示响应生命周期,可能为 queuedin_progresscompletedfailedcancelledincomplete 失败时查看 error.codeerror.message。若 statusincomplete,请检查 incomplete_details.reason,常见原因是触发输出上限或内容过滤。

output

模型生成的 item 数组。常见 item 包括:
  • message:assistant 文本、拒绝内容或引用。
  • reasoning:模型的推理 item;字段是否返回取决于模型和配置。
  • function_call:模型请求应用调用一个自定义函数。
  • web_search_callfile_search_callcode_interpreter_call 等:平台工具调用;仅在相应工具可用时出现。

其他回显字段

响应还可能回显或携带以下请求配置:
  • modelinstructionstoolstool_choiceparallel_tool_calls
  • temperaturetop_ptextreasoning
  • metadatastoretruncationservice_tier
  • previous_response_idconversationmax_output_tokensmax_tool_calls

usage

usage.input_tokensusage.output_tokensusage.total_tokens 分别表示输入、输出和总 token 数。 usage.input_tokens_details 可能包含 cached_tokenscache_write_tokensusage.output_tokens_details 可能包含 reasoning_tokens

message 输出 item

文本消息的典型结构如下:
content 可能包含:
  • output_text:最终文本,读取 text
  • refusal:拒绝说明,读取 refusal
  • 音频、引用或模型特定内容块:是否存在取决于模型和请求。
output_text.annotations 可包含 URL 引用、文件引用、容器文件引用或文件路径。请求 include: ["message.output_text.logprobs"] 后,output_text 还可能包含 logprobs

function_call 输出 item

函数调用 item 代表模型的调用意图,不代表函数已经被执行。
arguments 是 JSON 字符串,应用必须解析并校验。执行后,使用 call_id 构造下一轮的 function_call_output 输入 item。详见 函数调用

完整响应示例