Response 响应 chunk 对象(流式输出) 流式输出返回一系列 JSON 对象。每个对象包含 type 字段标识事件类型,sequence_number 字段标识事件顺序。response.completed 事件标志着流式传输的结束。 type string 事件类型标识符。枚举值:
response.created:响应创建时触发,状态为 queued。
response.in_progress:响应开始处理时触发,状态变为 in_progress。
response.output_item.added:新的输出项(如 message、web_extractor_call)被添加到 output 数组时触发。当 item.type 为 web_extractor_call 时,表示网页抽取工具调用开始。
response.content_part.added:输出项的 content 数组中新增内容块时触发。
response.output_text.delta:增量文本生成时触发,多次触发,delta 字段包含新增文本片段。
response.output_text.done:文本生成完成时触发,text 字段包含完整文本。
response.content_part.done:内容块完成时触发,part 对象包含完整内容块。
response.output_item.done:输出项生成完成时触发,item 对象包含完整输出项。当 item.type 为 web_extractor_call 时,表示网页抽取工具调用完成。
response.reasoning_text.delta:(开启思考模式时)推理摘要增量文本,delta 字段包含新增摘要片段。
response.reasoning_text.done:(开启思考模式时)推理摘要完成,text 字段包含完整摘要。
response.custom_tool_call_input.delta:自定义工具增量文本
response.custom_tool_call_input.done:自定义工具完成
response.web_search_call.in_progress / searching / completed:(使用 web_search 工具时)搜索状态变化事件。
response.code_interpreter_call.in_progress / interpreting / completed:(使用 code_interpreter 工具时)代码执行状态变化事件。
- 注意:使用
web_extractor 工具时,没有专门的事件类型标识符。网页抽取工具调用通过通用的 response.output_item.added 和 response.output_item.done 事件传递,通过 item.type 字段(值为 web_extractor_call)来识别。
response.incomplete:响应因 max_output_tokens等限制而提前结束
response.mcp_call_arguments.delta / response.mcp_call_arguments.done:(使用 mcp 工具时)MCP 调用参数的增量和完成事件。
response.mcp_call.in_progress:MCP 服务调用中。
response.mcp_call.completed:(使用 mcp 工具时)MCP 服务调用完成。
response.file_search_call.in_progress / searching / completed:(使用 file_search 工具时)知识库搜索状态变化事件。
- 注意:使用
web_search_image 和 image_search 工具时,没有专门的中间状态事件。工具调用通过 response.output_item.added(调用开始)和 response.output_item.done(调用完成)事件传递。
response.completed:响应生成完成时触发,response 对象包含完整响应(含 usage)。此事件标志流式传输结束。
sequence_number integer 事件序列号,从 0 开始递增。用于确保客户端按正确顺序处理事件。 response object 响应对象。出现在 response.created、response.in_progress 和 response.completed 事件中。在 response.completed 事件中包含完整的响应数据(包括 output 和 usage),其结构与非流式响应的 Response 对象一致。 item object 输出项对象。出现在 response.output_item.added 和 response.output_item.done 事件中。在 added 事件中为初始骨架(content 为空数组),在 done 事件中为完整对象。 属性 id string 输出项的唯一标识符(如 msg_xxx)。 type string 输出项类型。枚举值:message(消息)、reasoning(推理)、web_search_call(搜索)、web_search_image_call(文搜图)、image_search_call(图搜图)、mcp_call(MCP 调用)、file_search_call(知识库搜索)。 role string 消息角色,固定为 assistant。仅当 type 为 message 时存在。 status string 生成状态。在 added 事件中为 in_progress,在 done 事件中为 completed。 content array 消息内容数组。在 added 事件中为空数组 [],在 done 事件中包含完整的内容块对象(结构与 part 对象相同)。 part object 内容块对象。出现在 response.content_part.added 和 response.content_part.done 事件中。 属性 type string 内容块类型,固定为 output_text。 text string 文本内容。在 added 事件中为空字符串,在 done 事件中为完整文本。 annotations array 文本注释数组。通常为空数组。 logprobs object | null Token 的对数概率信息。当前固定返回 null。 delta string 增量文本内容。出现在 response.output_text.delta 事件中,包含本次新增的文本片段。客户端应将所有 delta 拼接以获得完整文本。 text string 完整文本内容。出现在 response.output_text.done 事件中,包含该内容块的完整文本,可用于校验 delta 拼接结果。 item_id string 输出项的唯一标识符。用于关联同一输出项的相关事件。 output_index integer 输出项在 output 数组中的索引位置。 content_index integer 内容块在 content 数组中的索引位置。 | // response.created - 响应创建
{"response":{"id":"428c90e9-9cd6-90a6-9726-c02b08ebexxx","created_at":1769082930,"object":"response","status":"queued",...},"sequence_number":0,"type":"response.created"}
// response.in_progress - 响应进行中
{"response":{"id":"428c90e9-9cd6-90a6-9726-c02b08ebexxx","status":"in_progress",...},"sequence_number":1,"type":"response.in_progress"}
// response.output_item.added - 新增输出项
{"item":{"id":"msg_bcb45d66-fc34-46a2-bb56-714a51e8exxx","content":[],"role":"assistant","status":"in_progress","type":"message"},"output_index":0,"sequence_number":2,"type":"response.output_item.added"}
// response.content_part.added - 新增内容块
{"content_index":0,"item_id":"msg_bcb45d66-fc34-46a2-bb56-714a51e8exxx","output_index":0,"part":{"annotations":[],"text":"","type":"output_text","logprobs":null},"sequence_number":3,"type":"response.content_part.added"}
// response.output_text.delta - 增量文本(多次触发)
{"content_index":0,"delta":"人工智能","item_id":"msg_bcb45d66-fc34-46a2-bb56-714a51e8exxx","logprobs":[],"output_index":0,"sequence_number":4,"type":"response.output_text.delta"}
{"content_index":0,"delta":"(Artificial Intelligence,","item_id":"msg_bcb45d66-fc34-46a2-bb56-714a51e8exxx","logprobs":[],"output_index":0,"sequence_number":6,"type":"response.output_text.delta"}
// response.output_text.done - 文本完成
{"content_index":0,"item_id":"msg_bcb45d66-fc34-46a2-bb56-714a51e8exxx","logprobs":[],"output_index":0,"sequence_number":53,"text":"人工智能(Artificial Intelligence,简称 AI)是指由计算机系统模拟人类智能行为的技术和科学...","type":"response.output_text.done"}
// response.content_part.done - 内容块完成
{"content_index":0,"item_id":"msg_bcb45d66-fc34-46a2-bb56-714a51e8exxx","output_index":0,"part":{"annotations":[],"text":"...完整文本...","type":"output_text","logprobs":null},"sequence_number":54,"type":"response.content_part.done"}
// response.output_item.done - 输出项完成
{"item":{"id":"msg_bcb45d66-fc34-46a2-bb56-714a51e8exxx","content":[{"annotations":[],"text":"...完整文本...","type":"output_text","logprobs":null}],"role":"assistant","status":"completed","type":"message"},"output_index":0,"sequence_number":55,"type":"response.output_item.done"}
// response.completed - 响应完成(包含完整响应和 usage)
{"response":{"id":"428c90e9-9cd6-90a6-9726-c02b08ebexxx","created_at":1769082930,"model":"qwen3.7-max","object":"response","output":[...],"status":"completed","usage":{"input_tokens":37,"output_tokens":243,"total_tokens":280,...}},"sequence_number":56,"type":"response.completed"}
id:1
event:response.created
:HTTP_STATUS/200
data:{"sequence_number":0,"type":"response.created","response":{"output":[],"parallel_tool_calls":false,"created_at":1769435906,"tool_choice":"auto","model":"","id":"863df8d9-cb29-4239-a54f-3e15a2427xxx","tools":[],"object":"response","status":"queued"}}
id:2
event:response.in_progress
:HTTP_STATUS/200
data:{"sequence_number":1,"type":"response.in_progress","response":{"output":[],"parallel_tool_calls":false,"created_at":1769435906,"tool_choice":"auto","model":"","id":"863df8d9-cb29-4239-a54f-3e15a2427xxx","tools":[],"object":"response","status":"in_progress"}}
id:3
event:response.output_item.added
:HTTP_STATUS/200
data:{"sequence_number":2,"item":{"summary":[],"type":"reasoning","id":"msg_5bd0c6df-19b8-4a04-bc00-8042a224exxx"},"output_index":0,"type":"response.output_item.added"}
id:4
event:response.reasoning_text.delta
:HTTP_STATUS/200
data:{"delta":"用户想要我:\n1. 搜索阿里云官网\n2. 提取官网首页的关键信息\n\n我需要先搜索阿里云官网的URL,然后使用web_extractor工具访问官网并提取关键信息。","sequence_number":3,"output_index":0,"type":"response.reasoning_text.delta","item_id":"msg_5bd0c6df-19b8-4a04-bc00-8042a224exxx"}
id:14
event:response.reasoning_text.done
:HTTP_STATUS/200
data:{"sequence_number":13,"text":"用户想要我:\n1. 搜索阿里云官网\n2. 提取官网首页的关键信息\n\n我需要先搜索阿里云官网的URL,然后使用web_extractor工具访问官网并提取关键信息。","output_index":0,"type":"response.reasoning_text.done","item_id":"msg_5bd0c6df-19b8-4a04-bc00-8042a224exxx"}
id:15
event:response.output_item.done
:HTTP_STATUS/200
data:{"sequence_number":14,"item":{"summary":[{"type":"summary_text","text":"用户想要我:\n1. 搜索阿里云官网\n2. 提取官网首页的关键信息\n\n我需要先搜索阿里云官网的URL,然后使用web_extractor工具访问官网并提取关键信息。"}],"type":"reasoning","id":"msg_5bd0c6df-19b8-4a04-bc00-8042a224exxx"},"output_index":1,"type":"response.output_item.done"}
id:16
event:response.output_item.added
:HTTP_STATUS/200
data:{"sequence_number":15,"item":{"action":{"type":"search","query":"Web search"},"id":"msg_a8a686b1-0a57-40e1-bb55-049a89cd4xxx","type":"web_search_call","status":"in_progress"},"output_index":1,"type":"response.output_item.added"}
id:17
event:response.web_search_call.in_progress
:HTTP_STATUS/200
data:{"sequence_number":16,"output_index":1,"type":"response.web_search_call.in_progress","item_id":"msg_a8a686b1-0a57-40e1-bb55-049a89cd4xxx"}
id:19
event:response.web_search_call.completed
:HTTP_STATUS/200
data:{"sequence_number":18,"output_index":1,"type":"response.web_search_call.completed","item_id":"msg_a8a686b1-0a57-40e1-bb55-049a89cd4xxx"}
id:20
event:response.output_item.done
:HTTP_STATUS/200
data:{"sequence_number":19,"item":{"action":{"sources":[{"type":"url","url":"https://cn.aliyun.com/"},{"type":"url","url":"https://www.aliyun.com/"}],"type":"search","query":"Web search"},"id":"msg_a8a686b1-0a57-40e1-bb55-049a89cd4xxx","type":"web_search_call","status":"completed"},"output_index":1,"type":"response.output_item.done"}
id:33
event:response.output_item.added
:HTTP_STATUS/200
data:{"sequence_number":32,"item":{"urls":["https://cn.aliyun.com/"],"goal":"提取阿里云官网首页的关键信息,包括:公司定位/简介、核心产品与服务、主要业务板块、特色功能/解决方案、最新动态/活动、免费试用/优惠信息、导航菜单结构等","id":"msg_8c2cf651-48a5-460c-aa7a-bea5b09b4xxx","type":"web_extractor_call","status":"in_progress"},"output_index":3,"type":"response.output_item.added"}
id:34
event:response.output_item.done
:HTTP_STATUS/200
data:{"sequence_number":33,"item":{"output":"The useful information in https://cn.aliyun.com/ for user goal 提取阿里云官网首页的关键信息,包括:公司定位/简介、核心产品与服务、主要业务板块、特色功能/解决方案、最新动态/活动、免费试用/优惠信息、导航菜单结构等 as follows: \n\nEvidence in page: \n## 通义大模型,企业拥抱 AI 时代首选\n\n## 完整的产品体系,为企业打造技术创新的云\n\n全部云产品## 依托大模型与云计算协同发展,让 AI 触手可及\n\n全部 AI 解决方案\n\nSummary: \nAlibaba Cloud positions itself as a leading enterprise AI solution provider centered around the Tongyi large model...","urls":["https://cn.aliyun.com/"],"goal":"提取阿里云官网首页的关键信息,包括:公司定位/简介、核心产品与服务、主要业务板块、特色功能/解决方案、最新动态/活动、免费试用/优惠信息、导航菜单结构等","id":"msg_8c2cf651-48a5-460c-aa7a-bea5b09b4xxx","type":"web_extractor_call","status":"completed"},"output_index":3,"type":"response.output_item.done"}
id:50
event:response.output_item.added
:HTTP_STATUS/200
data:{"sequence_number":50,"item":{"content":[{"type":"text","text":""}],"type":"message","id":"msg_final","role":"assistant"},"output_index":5,"type":"response.output_item.added"}
id:51
event:response.output_text.delta
:HTTP_STATUS/200
data:{"delta":"我已经找到阿里云官网并提取了首页的关键信息:\n\n","sequence_number":51,"output_index":5,"type":"response.output_text.delta"}
id:60
event:response.completed
:HTTP_STATUS/200
data:{"type":"response.completed","response":{"id":"863df8d9-cb29-4239-a54f-3e15a2427xxx","status":"completed","usage":{"input_tokens":45,"output_tokens":320,"total_tokens":365}}}
// 1. response.created - 响应创建
id:1
event:response.created
data:{"sequence_number":0,"type":"response.created","response":{"output":[],"status":"queued",...}}
// 2. response.in_progress - 响应进行中
id:2
event:response.in_progress
data:{"sequence_number":1,"type":"response.in_progress","response":{"status":"in_progress",...}}
// 3. response.output_item.added - 推理开始(reasoning)
id:3
event:response.output_item.added
data:{"sequence_number":2,"item":{"summary":[],"type":"reasoning","id":"msg_xxx"},"output_index":0,"type":"response.output_item.added"}
// 4. response.reasoning_text.delta - 推理摘要增量
id:4
event:response.reasoning_text.delta
data:{"delta":"用户想要找一张猫咪图片。我需要使用web_search_image工具来搜索...","sequence_number":3,"output_index":0,"type":"response.reasoning_text.delta","item_id":"msg_xxx"}
// 5. response.reasoning_text.done - 推理摘要完成
id:10
event:response.reasoning_text.done
data:{"sequence_number":9,"text":"用户想要找一张猫咪图片。我需要使用web_search_image工具来搜索猫咪图片。","output_index":0,"type":"response.reasoning_text.done","item_id":"msg_xxx"}
// 6. response.output_item.done - 推理项完成
id:11
event:response.output_item.done
data:{"sequence_number":10,"item":{"summary":[{"type":"summary_text","text":"..."}],"type":"reasoning","id":"msg_xxx"},"output_index":0,"type":"response.output_item.done"}
// 7. response.output_item.added - 文搜图工具调用开始(status: in_progress,此时已包含 name 和 arguments)
id:12
event:response.output_item.added
data:{"sequence_number":11,"item":{"name":"web_search_image","arguments":"{\"queries\": [\"猫咪图片\", \"cute cat\"]}","id":"msg_xxx","type":"web_search_image_call","status":"in_progress"},"output_index":1,"type":"response.output_item.added"}
// 8. response.output_item.done - 文搜图工具调用完成(包含完整的 output 搜索结果)
id:13
event:response.output_item.done
data:{"sequence_number":12,"item":{"name":"web_search_image","output":"[{\"title\": \"可爱的小猫咪...\", \"url\": \"https://example.com/cat.jpg\", \"index\": 1}, ...]","arguments":"{\"queries\": [\"猫咪图片\", \"cute cat\"]}","id":"msg_xxx","type":"web_search_image_call","status":"completed"},"output_index":1,"type":"response.output_item.done"}
// 9-12. 第二轮推理 + 最终消息输出(与基础调用相同)
// response.output_item.added (reasoning) → reasoning_text.delta/done → response.output_item.done (reasoning)
// response.output_item.added (message) → response.content_part.added → response.output_text.delta → response.output_text.done → response.content_part.done → response.output_item.done (message)
// 13. response.completed - 响应完成
id:118
event:response.completed
data:{"sequence_number":117,"type":"response.completed","response":{"output":[...],"status":"completed","usage":{"input_tokens":7895,"output_tokens":318,"total_tokens":8213,"x_tools":{"web_search_image":{"count":1}}}}}
// 1-6. 推理阶段(与文搜图相同)
// 7. response.output_item.added - 图搜图工具调用开始
// 注意 arguments 中包含 img_idx(图片索引)和 bbox(搜索区域边界框)
id:29
event:response.output_item.added
data:{"sequence_number":29,"item":{"name":"image_search","arguments":"{\"img_idx\": 0, \"bbox\": [0, 0, 1000, 1000]}","id":"msg_xxx","type":"image_search_call","status":"in_progress"},"output_index":1,"type":"response.output_item.added"}
// 8. response.output_item.done - 图搜图工具调用完成
id:30
event:response.output_item.done
data:{"sequence_number":30,"item":{"name":"image_search","output":"[{\"title\": \"水墨山背景...\", \"url\": \"https://example.com/landscape.jpg\", \"index\": 1}, ...]","arguments":"{\"img_idx\": 0, \"bbox\": [0, 0, 1000, 1000]}","id":"msg_xxx","type":"image_search_call","status":"completed"},"output_index":1,"type":"response.output_item.done"}
// 9-12. 第二轮推理 + 最终消息输出(与基础调用相同)
// 13. response.completed
id:408
event:response.completed
data:{"sequence_number":407,"type":"response.completed","response":{"output":[...],"status":"completed","usage":{"input_tokens":8371,"output_tokens":417,"total_tokens":8788,"x_tools":{"image_search":{"count":1}}}}}
// 1-6. 推理阶段(与其他工具相同)
// 7. response.mcp_call_arguments.delta - MCP 参数增量(MCP 独有事件)
id:27
event:response.mcp_call_arguments.delta
data:{"delta":"{\"city\": \"北京\"}","sequence_number":26,"output_index":1,"type":"response.mcp_call_arguments.delta","item_id":"msg_xxx"}
// 8. response.mcp_call_arguments.done - MCP 参数完成(MCP 独有事件)
id:28
event:response.mcp_call_arguments.done
data:{"sequence_number":27,"arguments":"{\"city\": \"北京\"}","output_index":1,"type":"response.mcp_call_arguments.done","item_id":"msg_xxx"}
// 9. response.output_item.added - MCP 工具调用开始(包含 name、server_label、arguments)
id:29
event:response.output_item.added
data:{"sequence_number":28,"item":{"name":"amap-maps-maps_weather","server_label":"MCP Server","arguments":"{\"city\": \"北京\"}","id":"msg_xxx","type":"mcp_call","status":"in_progress"},"output_index":1,"type":"response.output_item.added"}
// 10. response.mcp_call.completed - MCP 调用完成(MCP 独有事件)
id:30
event:response.mcp_call.completed
data:{"sequence_number":29,"output_index":1,"type":"response.mcp_call.completed","item_id":"msg_xxx"}
// 11. response.output_item.done - MCP 输出项完成(包含完整 output)
id:31
event:response.output_item.done
data:{"sequence_number":30,"item":{"output":"{\"city\":\"北京市\",\"forecasts\":[...]}","name":"amap-maps-maps_weather","server_label":"MCP Server","arguments":"{\"city\": \"北京\"}","id":"msg_xxx","type":"mcp_call","status":"completed"},"output_index":1,"type":"response.output_item.done"}
// 12-15. 第二轮推理 + 最终消息输出
// 16. response.completed
id:172
event:response.completed
data:{"sequence_number":171,"type":"response.completed","response":{"output":[...],"status":"completed","usage":{"input_tokens":5019,"output_tokens":539,"total_tokens":5558}}}
// 1-6. 推理阶段(与其他工具相同)
// 7. response.output_item.added - 知识库搜索开始(包含 queries,无 results)
id:19
event:response.output_item.added
data:{"sequence_number":18,"item":{"id":"msg_xxx","type":"file_search_call","queries":["阿里云百炼X1手机","Alibaba Cloud Bailian X1 phone","百炼X1"],"status":"in_progress"},"output_index":1,"type":"response.output_item.added"}
// 8. response.file_search_call.in_progress - 搜索进行中(file_search 独有事件)
id:20
event:response.file_search_call.in_progress
data:{"sequence_number":19,"output_index":1,"type":"response.file_search_call.in_progress","item_id":"msg_xxx"}
// 9. response.file_search_call.searching - 正在搜索(file_search 独有事件)
id:21
event:response.file_search_call.searching
data:{"sequence_number":20,"output_index":1,"type":"response.file_search_call.searching","item_id":"msg_xxx"}
// 10. response.file_search_call.completed - 搜索完成(file_search 独有事件)
id:22
event:response.file_search_call.completed
data:{"sequence_number":21,"output_index":1,"type":"response.file_search_call.completed","item_id":"msg_xxx"}
// 11. response.output_item.done - 输出项完成(包含 queries + results)
id:23
event:response.output_item.done
data:{"sequence_number":22,"item":{"id":"msg_xxx","type":"file_search_call","queries":["阿里云百炼X1手机","Alibaba Cloud Bailian X1 phone","百炼X1"],"results":[{"score":0.7519,"filename":"阿里云百炼系列手机产品介绍","text":"阿里云百炼 X1 ——畅享极致视界...","file_id":"file_xxx"}],"status":"completed"},"output_index":1,"type":"response.output_item.done"}
// 12-15. 第二轮推理 + 最终消息输出
// 16. response.completed
id:146
event:response.completed
data:{"sequence_number":145,"type":"response.completed","response":{"output":[...],"status":"completed","usage":{"input_tokens":1576,"output_tokens":722,"total_tokens":2298,"x_tools":{"file_search":{"count":1}}}}}
|