*response object | 响应对象 *response.created.response *创建状态的响应。包含参数与非流式调用返回的参数一致。 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *created_at integer | 创建时间戳 *response.created.response.created_at *该 Response 创建时的 Unix 时间戳（单位：秒）。 *id string | 响应 ID *response.created.response.id *本次 Response 的唯一标识，可用于后续查询、续接或删除该响应。 *model string | 模型 ID *response.created.response.model *生成本次响应所使用的模型标识，回显请求中的 model 字段。 *object string | 对象类型 *response.created.response.object *返回对象的类型标识，用于区分响应对象种类。 *取值固定为 response。 *output object[] | 输出内容 *response.created.response.output *模型本次响应产出的 Item 列表，按生成顺序排列，可能包含消息、工具调用、推理等不同类型条目。 * * * * * * * * * * * * *消息输出 object *模型生成的消息输出，包含文本内容。 * * * * * * * *content object[] | 输出内容 *response.created.response.output.content *输出内容列表。 * * *模型回答文本 object *模型生成的最终回答文本。 * * * *type string | 类型 *response.created.response.output.content.type *内容类型判别字段，用于区分 union 变体。 *取值固定为 output_text。 *annotations object[] | 标注列表 *response.created.response.output.content.annotations *文本附带的标注信息列表（如引用来源等） * * *网页引用 object *引用自互联网网页的标注信息。 * * * * * * * * * * *title string | 标题 *response.created.response.output.content.annotations.title *引用网页的标题。 *type string | 类型 *response.created.response.output.content.annotations.type *标注类型的判别字段（discriminator）。 *取值固定为 url_citation。 *url string | 网址 *response.created.response.output.content.annotations.url *引用网页的 URL 地址。 *cover_image object | 封面图 *response.created.response.output.content.annotations.cover_image *网页封面图片信息。 * * * *height integer | 高度 *response.created.response.output.content.annotations.cover_image.height *封面图片高度（像素） *url string | 图片地址 *response.created.response.output.content.annotations.cover_image.url *封面图片的 URL 地址。 *width integer | 宽度 *response.created.response.output.content.annotations.cover_image.width *封面图片宽度（像素） *freshness_info string | 新鲜度 *response.created.response.output.content.annotations.freshness_info *内容新鲜度信息。 *logo_url string | Logo 地址 *response.created.response.output.content.annotations.logo_url *网站 Logo 图标地址。 *mobile_url string | 移动端地址 *response.created.response.output.content.annotations.mobile_url *移动端访问地址。 *publish_time string | 发布时间 *response.created.response.output.content.annotations.publish_time *网页发布时间。 *site_name string | 站点名 *response.created.response.output.content.annotations.site_name *站点名称。 *summary string | 摘要 *response.created.response.output.content.annotations.summary *网页内容摘要。 *文档引用 object *引用自私域知识库文档的标注信息。 * * * * * *type string | 类型 *response.created.response.output.content.annotations.type *标注类型。 *取值固定为 doc_citation。 *chunk_attachment object[] | 分块附件 *response.created.response.output.content.annotations.chunk_attachment *引用分块附带的附件信息列表。 *chunk_id integer | 分块 ID *response.created.response.output.content.annotations.chunk_id *引用文档分块的 ID。 *doc_id string | 文档 ID *response.created.response.output.content.annotations.doc_id *引用文档的 ID。 *doc_name string | 文档名 *response.created.response.output.content.annotations.doc_name *引用文档的名称。 *text string | 文本内容 *response.created.response.output.content.text *模型生成的文本内容。 *模型思维链文本 object *模型生成的思维链文本。 * * * *type string | 类型 *response.created.response.output.content.type *内容类型标识，用于区分 union 变体。 *取值固定为 reasoning_text。 *annotations object[] | 标注列表 *response.created.response.output.content.annotations *思维链附带的标注信息列表。 * * *网页引用 object *引用自互联网网页的标注信息。 * * * * * * * * * * *title string | 标题 *response.created.response.output.content.annotations.title *引用网页的标题。 *type string | 类型 *response.created.response.output.content.annotations.type *标注类型的判别字段（discriminator）。 *取值固定为 url_citation。 *url string | 网址 *response.created.response.output.content.annotations.url *引用网页的 URL 地址。 *cover_image object | 封面图 *response.created.response.output.content.annotations.cover_image *网页封面图片信息。 * * * *height integer | 高度 *response.created.response.output.content.annotations.cover_image.height *封面图片高度（像素） *url string | 图片地址 *response.created.response.output.content.annotations.cover_image.url *封面图片的 URL 地址。 *width integer | 宽度 *response.created.response.output.content.annotations.cover_image.width *封面图片宽度（像素） *freshness_info string | 新鲜度 *response.created.response.output.content.annotations.freshness_info *内容新鲜度信息。 *logo_url string | Logo 地址 *response.created.response.output.content.annotations.logo_url *网站 Logo 图标地址。 *mobile_url string | 移动端地址 *response.created.response.output.content.annotations.mobile_url *移动端访问地址。 *publish_time string | 发布时间 *response.created.response.output.content.annotations.publish_time *网页发布时间。 *site_name string | 站点名 *response.created.response.output.content.annotations.site_name *站点名称。 *summary string | 摘要 *response.created.response.output.content.annotations.summary *网页内容摘要。 *文档引用 object *引用自私域知识库文档的标注信息。 * * * * * *type string | 类型 *response.created.response.output.content.annotations.type *标注类型。 *取值固定为 doc_citation。 *chunk_attachment object[] | 分块附件 *response.created.response.output.content.annotations.chunk_attachment *引用分块附带的附件信息列表。 *chunk_id integer | 分块 ID *response.created.response.output.content.annotations.chunk_id *引用文档分块的 ID。 *doc_id string | 文档 ID *response.created.response.output.content.annotations.doc_id *引用文档的 ID。 *doc_name string | 文档名 *response.created.response.output.content.annotations.doc_name *引用文档的名称。 *text string | 文本内容 *response.created.response.output.content.text *模型思维链文本内容。 *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *role string | 角色 *response.created.response.output.role *消息发送者的角色。 *取值固定为 assistant。 *status string | 状态 *response.created.response.output.status *消息输出条目的当前状态。 *completed：消息已生成完毕。 *in_progress：消息正在生成中（流式场景）。 *incomplete：消息未完整生成（例如达到 max_output_tokens 上限）。 *failed：消息生成失败。 *type string | 类型 *response.created.response.output.type *输出条目的类型标识。 *取值固定为 message。 *partial boolean | 增量片段 *response.created.response.output.partial *是否为流式增量片段。 *phase string | 消息阶段 *response.created.response.output.phase *标记 assistant 消息属于中间讲解还是最终回答。在回放 assistant 历史消息时，建议保留并原样回传该字段。可选值：commentary、final_answer。 *函数调用输出 object *模型发起的函数调用请求。 * * * * * * *type string | 类型 *response.created.response.output.type *输出条目类型标识，用于区分 OutputItem 变体。 *取值固定为 function_call。 *arguments string | 参数 *response.created.response.output.arguments *函数参数的 JSON 字符串。 *call_id string | 调用 ID *response.created.response.output.call_id *函数调用的唯一标识 ID，用于将该 function_call 输出与后续回传的 function_call_output 关联匹配。 *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *name string | 函数名 *response.created.response.output.name *调用的函数名称。 *status string | 状态 *response.created.response.output.status *函数调用条目的当前状态。 *completed：函数调用请求已生成完毕。 *in_progress：函数调用请求正在生成中（流式场景）。 *incomplete：函数调用请求未完整生成（例如达到 max_output_tokens 上限）。 *failed：函数调用生成失败。 *思维链输出 object *模型的深度思考过程输出。 * * * * * * *status string | 状态 *response.created.response.output.status *推理条目的处理状态，用于判断思维链是否生成完成。可选值：completed、failed、in_progress、incomplete。 *summary object[] | 推理摘要 *response.created.response.output.summary *推理摘要内容列表。 * * *type string | 类型 *response.created.response.output.summary.type *摘要片段类型标识。 *取值固定为 summary_text。 *text string | 摘要文本 *response.created.response.output.summary.text *思维链摘要文本内容。 *type string | 类型 *response.created.response.output.type *输出条目类型标识，用于区分 OutputItem 变体。 *取值固定为 reasoning。 *content object[] | 推理内容 *response.created.response.output.content *思维链推理过程的内容元素列表。 * * *模型回答文本 object *模型生成的最终回答文本。 * * * *type string | 类型 *response.created.response.output.content.type *内容类型判别字段，用于区分 union 变体。 *取值固定为 output_text。 *annotations object[] | 标注列表 *response.created.response.output.content.annotations *文本附带的标注信息列表（如引用来源等） * * *网页引用 object *引用自互联网网页的标注信息。 * * * * * * * * * * *title string | 标题 *response.created.response.output.content.annotations.title *引用网页的标题。 *type string | 类型 *response.created.response.output.content.annotations.type *标注类型的判别字段（discriminator）。 *取值固定为 url_citation。 *url string | 网址 *response.created.response.output.content.annotations.url *引用网页的 URL 地址。 *cover_image object | 封面图 *response.created.response.output.content.annotations.cover_image *网页封面图片信息。 * * * *height integer | 高度 *response.created.response.output.content.annotations.cover_image.height *封面图片高度（像素） *url string | 图片地址 *response.created.response.output.content.annotations.cover_image.url *封面图片的 URL 地址。 *width integer | 宽度 *response.created.response.output.content.annotations.cover_image.width *封面图片宽度（像素） *freshness_info string | 新鲜度 *response.created.response.output.content.annotations.freshness_info *内容新鲜度信息。 *logo_url string | Logo 地址 *response.created.response.output.content.annotations.logo_url *网站 Logo 图标地址。 *mobile_url string | 移动端地址 *response.created.response.output.content.annotations.mobile_url *移动端访问地址。 *publish_time string | 发布时间 *response.created.response.output.content.annotations.publish_time *网页发布时间。 *site_name string | 站点名 *response.created.response.output.content.annotations.site_name *站点名称。 *summary string | 摘要 *response.created.response.output.content.annotations.summary *网页内容摘要。 *文档引用 object *引用自私域知识库文档的标注信息。 * * * * * *type string | 类型 *response.created.response.output.content.annotations.type *标注类型。 *取值固定为 doc_citation。 *chunk_attachment object[] | 分块附件 *response.created.response.output.content.annotations.chunk_attachment *引用分块附带的附件信息列表。 *chunk_id integer | 分块 ID *response.created.response.output.content.annotations.chunk_id *引用文档分块的 ID。 *doc_id string | 文档 ID *response.created.response.output.content.annotations.doc_id *引用文档的 ID。 *doc_name string | 文档名 *response.created.response.output.content.annotations.doc_name *引用文档的名称。 *text string | 文本内容 *response.created.response.output.content.text *模型生成的文本内容。 *模型思维链文本 object *模型生成的思维链文本。 * * * *type string | 类型 *response.created.response.output.content.type *内容类型标识，用于区分 union 变体。 *取值固定为 reasoning_text。 *annotations object[] | 标注列表 *response.created.response.output.content.annotations *思维链附带的标注信息列表。 * * *网页引用 object *引用自互联网网页的标注信息。 * * * * * * * * * * *title string | 标题 *response.created.response.output.content.annotations.title *引用网页的标题。 *type string | 类型 *response.created.response.output.content.annotations.type *标注类型的判别字段（discriminator）。 *取值固定为 url_citation。 *url string | 网址 *response.created.response.output.content.annotations.url *引用网页的 URL 地址。 *cover_image object | 封面图 *response.created.response.output.content.annotations.cover_image *网页封面图片信息。 * * * *height integer | 高度 *response.created.response.output.content.annotations.cover_image.height *封面图片高度（像素） *url string | 图片地址 *response.created.response.output.content.annotations.cover_image.url *封面图片的 URL 地址。 *width integer | 宽度 *response.created.response.output.content.annotations.cover_image.width *封面图片宽度（像素） *freshness_info string | 新鲜度 *response.created.response.output.content.annotations.freshness_info *内容新鲜度信息。 *logo_url string | Logo 地址 *response.created.response.output.content.annotations.logo_url *网站 Logo 图标地址。 *mobile_url string | 移动端地址 *response.created.response.output.content.annotations.mobile_url *移动端访问地址。 *publish_time string | 发布时间 *response.created.response.output.content.annotations.publish_time *网页发布时间。 *site_name string | 站点名 *response.created.response.output.content.annotations.site_name *站点名称。 *summary string | 摘要 *response.created.response.output.content.annotations.summary *网页内容摘要。 *文档引用 object *引用自私域知识库文档的标注信息。 * * * * * *type string | 类型 *response.created.response.output.content.annotations.type *标注类型。 *取值固定为 doc_citation。 *chunk_attachment object[] | 分块附件 *response.created.response.output.content.annotations.chunk_attachment *引用分块附带的附件信息列表。 *chunk_id integer | 分块 ID *response.created.response.output.content.annotations.chunk_id *引用文档分块的 ID。 *doc_id string | 文档 ID *response.created.response.output.content.annotations.doc_id *引用文档的 ID。 *doc_name string | 文档名 *response.created.response.output.content.annotations.doc_name *引用文档的名称。 *text string | 文本内容 *response.created.response.output.content.text *模型思维链文本内容。 *encrypted_content string | 加密思维链 *response.created.response.output.encrypted_content *思考内容加密原文。经加密及压缩处理后的思考内容原文。 *相关文档： *关键规则 *回传思考内容加密块使用示例 *说明 *流式输出场景下，思考内容加密原文通过 response.output_item.added、response.output_item.done、response.completed 等相关事件下发，需要按事件中 encrypted_content 字段非空过滤获取。 *模型支持： *doubao-seed-2-0-lite-260428 及后续版本 *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *语音转写输出 object *模型返回的语音转写输出。 * * * * *status string | 状态 *response.created.response.output.status *语音转写条目的当前状态。 *completed：转写已生成完毕。 *in_progress：转写正在生成中（流式场景）。 *incomplete：转写未完整生成（例如达到输出上限而截断）。 *failed：转写生成失败。 *type string | 类型 *response.created.response.output.type *输出条目类型标识。 *取值固定为 transcription。 *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *transcription object[] | 转写内容 *response.created.response.output.transcription *语音转写结果片段列表。 * * * *type string | 类型 *response.created.response.output.transcription.type *转写片段类型。 *取值固定为 transcription_text。 *chunks object[] | 音频小段 *response.created.response.output.transcription.chunks *当前片段对应的音频小段列表。 * * * *end_time integer | 结束时间 *response.created.response.output.transcription.chunks.end_time *片段结束时间（毫秒） *start_time integer | 开始时间 *response.created.response.output.transcription.chunks.start_time *片段开始时间（毫秒） *text string | 文字内容 *response.created.response.output.transcription.chunks.text *当前片段对应的文字内容。 *text string | 转写文本 *response.created.response.output.transcription.text *当前片段的转写文本。 *网页搜索调用 object *模型发起的网页搜索调用记录。 * * * * *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *status string | 状态 *response.created.response.output.status *网页搜索调用的当前状态。可选值：in_progress、searching、completed、incomplete、failed。 *type string | 类型 *response.created.response.output.type *输出条目类型标识，用于区分 OutputItem 变体。 *取值固定为 web_search_call。 *action object | 搜索动作 *response.created.response.output.action *描述模型执行的网页搜索动作，包括搜索类型与查询关键字。 * * * *query string | 查询语句 *response.created.response.output.action.query *模型实际发起的搜索查询语句。 *type string | 类型 *response.created.response.output.action.type *网页搜索动作的类型标识。 *取值固定为 search。 *queries string[] | 查询语句列表 *response.created.response.output.action.queries *本次网页搜索产生的查询语句列表。 *图像处理调用 object *模型发起的图像处理调用记录。 * * * * * * *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *status string | 状态 *response.created.response.output.status *图像处理调用的当前状态。 *completed：图像处理已完成。 *in_progress：图像处理正在执行中。 *incomplete：图像处理未完整执行（例如被中断或截断）。 *failed：图像处理执行失败，具体原因见 error 字段。 *type string | 类型 *response.created.response.output.type *输出条目类型标识，用于区分 OutputItem 变体。 *取值固定为 image_process。 *action object | 处理动作 *response.created.response.output.action *图像处理动作详情。 * * *type string | 类型 *response.created.response.output.action.type *图像处理动作类型。 *result_image_url string | 结果图地址 *response.created.response.output.action.result_image_url *处理后图像的 URL 地址。 *arguments object | 处理参数 *response.created.response.output.arguments *图像处理动作的输入参数，以键值对形式承载具体处理选项。 *error object | 图像处理错误 *response.created.response.output.error *图像处理失败时的错误信息。 * *message string | 错误描述 *response.created.response.output.error.message *错误的可读描述。 *MCP 审批请求 object *MCP 工具调用前的审批请求记录。 * * * * * *arguments string | 调用参数 *response.created.response.output.arguments *工具调用参数的 JSON 字符串。 *name string | 工具名 *response.created.response.output.name *待运行的工具名称。 *server_label string | 服务标签 *response.created.response.output.server_label *发起请求的 MCP Server 标签。 *type string | 类型 *response.created.response.output.type *输出项类型标识符，用于区分 OutputItem 的变体。 *取值固定为 mcp_approval_request。 *id string | 请求 ID *response.created.response.output.id *审批请求的唯一 ID。 *MCP 工具清单 object *MCP Server 提供的工具清单输出。 * * * * * *server_label string | 服务标签 *response.created.response.output.server_label *MCP Server 标签。 *type string | 类型 *response.created.response.output.type *输出项类型标识。 *取值固定为 mcp_list_tools。 *error string | 错误信息 *response.created.response.output.error *当 MCP Server 无法返回工具列表时的错误信息。 *id string | 列表 ID *response.created.response.output.id *工具列表的唯一 ID。 *tools object[] | 工具列表 *response.created.response.output.tools *该 MCP Server 上可用的工具列表。 * * * * *name string | 工具名 *response.created.response.output.tools.name *工具名称。 *annotations object | 注解信息 *response.created.response.output.tools.annotations *工具的附加注解信息。 *description string | 工具描述 *response.created.response.output.tools.description *工具的功能描述。 *input_schema object | 入参 Schema *response.created.response.output.tools.input_schema *描述工具入参的 JSON Schema。 *MCP 工具调用 object *模型对 MCP 工具的实际调用记录及结果。 * * * * * * * *name string | 工具名 *response.created.response.output.name *实际运行的工具名称。 *server_label string | 服务标签 *response.created.response.output.server_label *运行工具的 MCP Server 标签。 *type string | 类型 *response.created.response.output.type *标识该输出项为 MCP 工具调用记录。 *取值固定为 mcp_call。 *arguments string | 调用参数 *response.created.response.output.arguments *传递给 MCP 工具的调用参数，格式为 JSON 字符串。 *说明 *该字段通过 response.mcp_call_arguments.delta 事件流式追加，初始 output_item.added 事件可能不携带该字段。 *error string | 错误信息 *response.created.response.output.error *工具调用失败时的错误信息。 *id string | 调用 ID *response.created.response.output.id *工具调用的唯一 ID。 *output string | 返回结果 *response.created.response.output.output *工具调用的返回结果。 *知识库检索调用 object *模型发起的私域知识库检索调用记录。 * * * * * *knowledge_resource_id string | 知识库 ID *response.created.response.output.knowledge_resource_id *检索使用的知识库 ID。 *queries string[] | 查询语句 *response.created.response.output.queries *模型实际执行的检索查询语句。 *status string | 状态 *response.created.response.output.status *知识库检索调用的执行状态。可选值：in_progress、searching、completed、failed、incomplete。 *type string | 类型 *response.created.response.output.type *输出条目类型标识，用于区分不同类型的输出条目。 *取值固定为 knowledge_search_call。 *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *豆包应用调用 object *模型对豆包助手能力的调用记录。 * * * * * *type string | 类型 *response.created.response.output.type *输出条目类型标识。 *取值固定为 doubao_app_call。 *blocks object[] | 内容块 *response.created.response.output.blocks *豆包应用调用产出的内容块列表。 * * * * *文本输出 object *豆包应用产出的文本输出内容块。 * * * * * *type string | 类型 *response.created.response.output.blocks.type *内容块类型标识符。 *取值固定为 output_text。 *id string | 块 ID *response.created.response.output.blocks.id *内容块的唯一标识。 *parent_id string | 父级 ID *response.created.response.output.blocks.parent_id *所属父级条目的 ID。 *status string | 状态 *response.created.response.output.blocks.status *内容块状态。 *text string | 文本内容 *response.created.response.output.blocks.text *思维链文本 object *豆包应用产出的思维链文本内容块。 * * * * * *type string | 类型 *response.created.response.output.blocks.type *内容块类型标识符。 *取值固定为 reasoning_text。 *id string | 块 ID *response.created.response.output.blocks.id *内容块的唯一标识。 *parent_id string | 父级 ID *response.created.response.output.blocks.parent_id *所属父级条目的 ID。 *reasoning_text string | 思考文本 *response.created.response.output.blocks.reasoning_text *思维链文本内容。 *status string | 状态 *response.created.response.output.blocks.status *内容块状态。 *搜索过程 object *豆包应用 AI 搜索过程产出的内容块。 * * * * * * * *type string | 类型 *response.created.response.output.blocks.type *内容块类型标识符。 *取值固定为 search。 *id string | 块 ID *response.created.response.output.blocks.id *内容块的唯一标识。 *parent_id string | 父级 ID *response.created.response.output.blocks.parent_id *所属父级条目的 ID。 *queries string[] | 查询语句 *response.created.response.output.blocks.queries *搜索查询语句列表。 *results object[] | 搜索结果 *response.created.response.output.blocks.results *搜索结果列表。 * *text_card object | 文本卡片 *response.created.response.output.blocks.results.text_card *文本卡片形式的搜索结果。 * * * *sitename string | 站点名 *response.created.response.output.blocks.results.text_card.sitename *来源站点名称。 *title string | 标题 *response.created.response.output.blocks.results.text_card.title *搜索结果标题。 *url string | 网址 *response.created.response.output.blocks.results.text_card.url *搜索结果 URL 地址。 *status string | 状态 *response.created.response.output.blocks.status *内容块状态。 *summary string | 搜索总结 *response.created.response.output.blocks.summary *AI 搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。 *推理搜索过程 object *豆包应用推理搜索过程产出的内容块。 * * * * * * * *type string | 类型 *response.created.response.output.blocks.type *内容块类型。 *取值固定为 reasoning_search。 *id string | 块 ID *response.created.response.output.blocks.id *内容块的唯一标识。 *parent_id string | 父级 ID *response.created.response.output.blocks.parent_id *所属父级条目的 ID。 *queries string[] | 查询语句 *response.created.response.output.blocks.queries *搜索查询语句列表。 *results object[] | 搜索结果 *response.created.response.output.blocks.results *搜索结果列表。 * *text_card object | 文本卡片 *response.created.response.output.blocks.results.text_card *文本卡片形式的搜索结果。 * * * *sitename string | 站点名 *response.created.response.output.blocks.results.text_card.sitename *来源站点名称。 *title string | 标题 *response.created.response.output.blocks.results.text_card.title *搜索结果标题。 *url string | 网址 *response.created.response.output.blocks.results.text_card.url *搜索结果 URL 地址。 *status string | 状态 *response.created.response.output.blocks.status *推理搜索内容块的处理状态。可选值：in_progress、searching、completed、incomplete、failed。 *summary string | 搜索总结 *response.created.response.output.blocks.summary *推理搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。 *feature string | 功能名 *response.created.response.output.feature *本次调用触发的豆包子功能名称。可选值：chat、deep_chat、ai_search、reasoning_search。 *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *status string | 状态 *response.created.response.output.status *输出状态。可选值：completed、failed、in_progress、incomplete。 *智能体工具调用 object *模型发起的智能体工具调用记录。 * * * * *name string | 工具名 *response.created.response.output.name *被调用的智能体工具名称。 *status string | 状态 *response.created.response.output.status *智能体工具调用的执行状态。可选值：completed、failed、in_progress、incomplete。 *type string | 类型 *response.created.response.output.type *输出条目类型标识符，用于区分 OutputItem 的 variant。 *取值固定为 agent_tool_call。 *id string | 条目 ID *response.created.response.output.id *输出条目唯一标识。 *caching object | 缓存配置 *response.created.response.caching *本次响应生效的上下文缓存配置，回显请求中的 caching 设置。 * * *prefix boolean | 仅写缓存 *response.created.response.caching.prefix *是否仅写入前缀缓存，不生成回复。true 只写缓存，不返回模型输出；false 正常生成回复并写缓存。 *type string | 缓存模式 *response.created.response.caching.type *缓存模式。 *enabled：开启上下文缓存。 *disabled：关闭上下文缓存。 *context_management object | 上下文管理 *response.created.response.context_management *本次响应实际执行的上下文管理编辑操作，回显请求中 context_management 生效后的结果。 * *applied_edits object[] | 已应用编辑 *response.created.response.context_management.applied_edits *已应用的上下文编辑结果列表。 * * *清理工具调用 object *已应用的清理工具调用编辑结果。 * * *cleared_tool_uses integer | 清理次数 *response.created.response.context_management.applied_edits.cleared_tool_uses *已清理的工具调用数量。 *type string | 类型 *response.created.response.context_management.applied_edits.type *编辑类型。 *取值固定为 clear_tool_uses。 *清理思维链 object *已应用的清理思维链编辑结果。 * * *cleared_thinking_turns integer | 清理轮次 *response.created.response.context_management.applied_edits.cleared_thinking_turns *已清理的思维链轮次数量。 *type string | 类型 *response.created.response.context_management.applied_edits.type *编辑类型。 *取值固定为 clear_thinking。 *error object | 错误信息 *response.created.response.error *模型响应过程发生错误时的错误信息。仅当 status 为 failed 时返回。 * * *code string | 错误码 *response.created.response.error.code *message string | 错误描述 *response.created.response.error.message *错误信息的可读描述。 *expire_at integer | 过期时间戳 *response.created.response.expire_at *响应储存的过期时刻 Unix 时间戳（秒），回显请求中的 expire_at 设置，对 store 与 caching 均生效。 *说明 *最多保留 7 天。 *incomplete_details object | 未完成详情 *response.created.response.incomplete_details *响应未能完成的详细信息。仅当 status 为 incomplete 时返回。 * * *reason string | 原因 *response.created.response.incomplete_details.reason *响应未完成的原因。 *content_filter object | 内容过滤 *response.created.response.incomplete_details.content_filter *内容过滤详情。 * * *details string | 详情 *response.created.response.incomplete_details.content_filter.details *内容过滤命中的详细描述。 *type string | 类型 *response.created.response.incomplete_details.content_filter.type *内容过滤命中的类型。 *instructions string | 系统指令 *response.created.response.instructions *本次响应生效的系统指令，回显请求中的 instructions 设置。 *max_output_tokens integer | 最大输出长度 *response.created.response.max_output_tokens *回显请求中的 max_output_tokens 参数，即模型输出最大 token 数（含回答与思维链）。 *max_tool_calls integer | 最大工具调用轮次 *response.created.response.max_tool_calls *本次响应生效的最大工具调用轮次，回显请求中的 max_tool_calls 设置。 *metadata object | 自定义元数据 *response.created.response.metadata *回显请求中的 metadata 键值对元数据。最多支持 16 对键值，key 长度不超过 64 个字符，value 长度不超过 512 个字符，服务端不会解释其中内容。 *parallel_tool_calls boolean | 并行工具调用 *response.created.response.parallel_tool_calls *本次请求实际生效的并行工具调用设置，回显请求中的 parallel_tool_calls 值。 *previous_response_id string | 上轮响应 ID *response.created.response.previous_response_id *回显请求中的 previous_response_id，即前一轮响应的唯一标识。仅在请求传入该字段时返回。 *prompt_cache_key string | 缓存分桶键 *response.created.response.prompt_cache_key *用于提升缓存命中率的分桶键，回显请求中的 prompt_cache_key 设置。 *reasoning object | 推理配置 *response.created.response.reasoning *本次响应生效的深度思考工作量配置，回显请求中的 reasoning 设置。 * *effort string | 思考深度 *response.created.response.reasoning.effort *限制思考的工作量。减少思考深度可提升速度，思考花费的 token 更少。 *none：关闭思考。 *minimal：关闭思考，直接回答。 *low：轻量思考，侧重快速响应。 *medium：均衡模式，兼顾速度与深度。 *high：深度分析，处理复杂问题。 *xhigh：更高程度思考。 *max：最高程度思考，适配高难度推理任务。 *说明 *支持该字段的模型、默认取值、参数兼容映射规则，以及与 thinking.type 字段的关系，详见 文档。 *safety_identifier string | 安全标识 *response.created.response.safety_identifier *回显请求中传入的终端用户稳定标识，用于安全策略与违规行为追踪关联。 *service_tier string | 推理模式 *response.created.response.service_tier *本次请求实际使用的推理模式。 *fast：本次请求使用 在线推理（低延迟） 模式。 *auto：本次请求使用 在线推理（TPM 保障包） 模式。 *default：本次请求使用 在线推理（常规） 模式。 *flex：本次请求使用 在线推理（低优） 模式。 *session object | 会话信息 *response.created.response.session *本次响应关联的会话信息，回显请求中 session 生效后的结果。 * *id string | 会话 ID *response.created.response.session.id *会话的唯一 ID。 *status string | 响应状态 *response.created.response.status *本次响应的当前状态，标识生成流程处于进行中、已完成、未完成或已失败等阶段。 *store boolean | 是否存储 *response.created.response.store *是否储存生成的模型响应以供后续通过 API 检索，回显请求中的 store 设置。 *temperature number | 采样温度 *response.created.response.temperature *本次响应生效的采样温度，回显请求中的 temperature 设置。 *text object | 输出格式 *response.created.response.text *本次响应生效的输出格式定义，回显请求中的 text 设置。 * *format object | 输出格式 *response.created.response.text.format *文本输出格式定义。 * * * * * *type string | 格式类型 *response.created.response.text.format.type *输出格式类型。可选值：text、json_schema、json_object。 *注意 *json_object / json_schema 能力尚在 beta 阶段，请谨慎在生产环境使用。 *description string | 格式描述 *response.created.response.text.format.description *格式描述信息。 *name string | 格式名称 *response.created.response.text.format.name *格式名称，作为 JSON Schema 输出格式的标识。 *注意 *仅当 type 为 json_schema 时需要提供此字段。 *schema object | Schema 定义 *response.created.response.text.format.schema *JSON Schema 定义。当 type 为 json_schema 时必填。 *strict boolean | 严格模式 *response.created.response.text.format.strict *是否严格按 JSON Schema 校验模型输出。 *注意 *仅当 type 为 json_schema 时生效。 *thinking object | 深度思考 *response.created.response.thinking *本次响应生效的深度思考配置，回显请求中的 thinking 设置。 * *type string | 思考模式 *response.created.response.thinking.type *深度思考模式。 *enabled：开启深度思考。 *disabled：关闭深度思考。 *tool_choice string / object | 工具调用策略 *response.created.response.tool_choice *本次请求实际生效的工具调用策略，回显请求中的 tool_choice 设置。 *说明 *未指定工具时默认值为 none；存在工具时默认值为 auto。 * * *简单策略 string *直接传入字符串 none、auto 或 required，控制工具调用整体策略。 *指定工具 object *通过对象指定具体工具类型或工具名进行调用。 * * *type string | 工具类型 *response.created.response.tool_choice.type *指定要调用的工具类型，用于精确路由到对应工具。可选值： *function *web_search *image_process *mcp *knowledge_search *doubao_app *name string | 工具名称 *response.created.response.tool_choice.name *指定要调用的具体工具名，如函数名或 MCP 服务下的工具名。 *tools object[] | 工具列表 *response.created.response.tools *本次响应生效的工具列表，回显请求中的 tools 设置。 * * * * * * *函数调用 object *自定义函数调用（Function Calling），让模型生成结构化的函数参数。 * * * * *name string | 函数名 *response.created.response.tools.name *供模型调用的函数名称，模型在 function_call 输出中以该名称回传，用于匹配对应函数。 *type string | 类型 *response.created.response.tools.type *工具类型标识，用于在 union 中区分不同工具类别。 *取值固定为 function。 *description string | 函数描述 *response.created.response.tools.description *函数的描述信息，帮助模型理解何时使用该函数。 *parameters object | 参数定义 *response.created.response.tools.parameters *函数参数定义，遵循 JSON Schema 格式。 *联网搜索 object *联网搜索工具，让模型在需要时自动进行网页搜索获取实时信息。 * * * * * *type string | 类型 *response.created.response.tools.type *工具类型标识，用于区分 Tool 的不同变体。 *取值固定为 web_search。 *limit integer | 最大结果数 *response.created.response.tools.limit *每轮搜索最大返回结果数量。 *说明 *单次搜索最多返回 20 条；单轮可能有多次搜索，最终召回条数受此参数限制影响。 *取值范围：[1, 50] *max_keyword integer | 最大关键词数 *response.created.response.tools.max_keyword *最大并行搜索关键词数量。 *取值范围：[1, 50] *sources string[] | 搜索来源 *response.created.response.tools.sources *搜索信息来源限制，指定模型可从哪些渠道检索网页内容。可选值：toutiao、douyin、moji、search_engine、doubao。 *说明 *doubao 不能与其他搜索来源同时配置。传入 ["doubao"] 时，tools.limit、tools.max_keyword、tools.user_location 均不生效，向它们传入的值将被忽略。 *user_location object | 用户位置 *response.created.response.tools.user_location *用户地理位置信息，用于搜索优化。 * * * * * *type string | 类型 *response.created.response.tools.user_location.type *位置类型。 *取值固定为 approximate。 *city string | 城市 *response.created.response.tools.user_location.city *用户所在城市。 *country string | 国家 *response.created.response.tools.user_location.country *用户所在国家。 *region string | 地区 *response.created.response.tools.user_location.region *用户所在地区。 *timezone number | 时区 *response.created.response.tools.user_location.timezone *用户所在时区。 *图像处理 object *图像处理工具，让模型对图片进行画点、选区、缩放、旋转等操作。 * * * * * *type string | 类型 *response.created.response.tools.type *工具类型标识，用于区分 Tool 的不同变体。 *取值固定为 image_process。 *grounding object | 选区功能 *response.created.response.tools.grounding *选区/裁切功能配置，启用后模型可返回图像中目标的检测框或裁切区域坐标。 * *type string | 开关 *response.created.response.tools.grounding.type *功能开关。可选值：enabled、disabled。 *point object | 画点功能 *response.created.response.tools.point *画点/画线功能开关。 * *type string | 开关 *response.created.response.tools.point.type *功能开关。可选值：enabled、disabled。 *rotate object | 旋转功能 *response.created.response.tools.rotate *旋转功能开关。启用后模型可请求对图片按指定角度进行旋转。 *注意 *旋转角度支持范围为 0-359 度。 * *type string | 开关 *response.created.response.tools.rotate.type *功能开关。可选值：enabled、disabled。 *zoom object | 缩放功能 *response.created.response.tools.zoom *缩放功能开关，启用后模型可对图像目标区域执行缩放操作。 *说明 *缩放倍率支持范围 0.5-2.0 倍。 * *type string | 开关 *response.created.response.tools.zoom.type *功能开关。可选值：enabled、disabled。 *MCP 工具 object *MCP（Model Context Protocol）工具，让模型调用外部 MCP Server 提供的工具。 * * * * * * * *server_label string | 服务标签 *response.created.response.tools.server_label *MCP Server 的唯一标识标签。模型在工具调用输出中通过该标签指向对应 Server，便于在多个 MCP Server 场景下区分调用来源。 *server_url string | 服务地址 *response.created.response.tools.server_url *MCP Server 的 HTTP(S) 访问地址，模型通过该地址向 Server 发起工具调用请求。 *type string | 类型 *response.created.response.tools.type *工具类型标识，用于区分 Tool 的不同变体。 *取值固定为 mcp。 *allowed_tools string[] / object | 允许工具 *response.created.response.tools.allowed_tools *允许模型调用的工具范围。可传工具名称字符串数组，或包含 tool_names 字段的过滤器对象。 * * *工具名数组 string[] *直接传入允许调用的工具名称数组。 *工具过滤器 object *通过过滤器对象指定允许调用的工具范围。 * *tool_names string[] | 工具名列表 *response.created.response.tools.allowed_tools.tool_names *允许调用的工具名称列表。 *headers object | 请求头 *response.created.response.tools.headers *调用 MCP Server 时附加的 HTTP 请求头，以字符串键值对形式指定 header 名与值。 *说明 *常用于传递鉴权信息（如 Authorization）。 *Authorization 字段不会被服务端存储。 *require_approval string / object | 审批策略 *response.created.response.tools.require_approval *MCP 工具调用前的审批策略；支持简单模式（字符串）或按工具粒度控制（过滤器对象）。 * * *简单策略 string *直接传入字符串 always 或 never，对所有工具应用统一审批策略。 *工具过滤器 object *通过过滤器对象按工具粒度配置审批策略。 * * *always object | 始终审批 *response.created.response.tools.require_approval.always *始终需要审批的工具过滤器。 * *tool_names string[] | 工具名列表 *response.created.response.tools.require_approval.always.tool_names *始终需要审批的工具名称列表。 *never object | 无需审批 *response.created.response.tools.require_approval.never *无需审批的工具过滤器。 * *tool_names string[] | 工具名列表 *response.created.response.tools.require_approval.never.tool_names *无需审批即可调用的工具名称列表。 *server_description string | 服务描述 *response.created.response.tools.server_description *MCP Server 的描述信息，帮助模型理解何时使用该 Server。 *知识库搜索 object *私域知识库搜索工具，让模型检索企业内部知识库中的文档内容。 * * * * * * * * *knowledge_resource_id string | 知识库 ID *response.created.response.tools.knowledge_resource_id *type string | 类型 *response.created.response.tools.type *工具类型标识，用于区分 Tool 的不同变体。 *取值固定为 knowledge_search。 *dense_weight number | 稠密权重 *response.created.response.tools.dense_weight *混合检索中稠密向量（语义）检索的权重，值越大越偏向语义匹配，越小越偏向关键词匹配。 *说明 *仅在混合检索（索引算法为 hnsw_hybrid）下生效。 *取值范围：[0.2, 1] *description string | 知识库描述 *response.created.response.tools.description *知识库描述信息，帮助模型理解何时使用该知识库。 *doc_filter object | 文档过滤 *response.created.response.tools.doc_filter *设置文档字段级别的检索过滤条件，确保只在符合条件的文档中检索。 *说明 *支持用作过滤条件的文档字段： *系统字段：doc_id（仅手动创建的知识库）、_sys_auto_doc_id（手动 + API 创建均适用） *自定义字段：已为知识库文档添加的文档标签（对应知识库 index_config.fields 中的 field） *支持单一条件过滤和多条件组合过滤（支持 And / Or 逻辑运算）。 *详细使用方式和支持字段参见 filter 表达式。 *若自定义字段类型为 Boolean，取值范围是 True / False，大小写规则：cURL 用 true / false，Python 用 True / False。 *limit integer | 最大结果数 *response.created.response.tools.limit *最大搜索结果数量。 *取值范围：[1, 200] *max_keyword integer | 最大关键词数 *response.created.response.tools.max_keyword *最大并行搜索关键词数量。 *取值范围：[1, 50] *ranking_options object | 排序选项 *response.created.response.tools.ranking_options *检索后处理选项。可参考 知识库 API 文档 post_processing 字段。 * * * * * * * *chunk_diffusion_count integer | 切片扩散数 *response.created.response.tools.ranking_options.chunk_diffusion_count *检索阶段返回命中切片的上下几片邻近切片。取 0 表示不进行 chunk diffusion。 *取值范围：[0, 5] *chunk_group boolean | 文本聚合 *response.created.response.tools.ranking_options.chunk_group *文本聚合。 *默认不聚合。 *对于非结构化文件，可开启文本聚合以更好保留原文档内容语序。 *开启后，会根据文档及文档顺序，对切片重新聚合排序返回。 *get_attachment_link boolean | 获取附件链接 *response.created.response.tools.ranking_options.get_attachment_link *是否获取切片中图片的临时下载链接。 *rerank_model string | Rerank 模型 *response.created.response.tools.ranking_options.rerank_model *rerank 模型选择。默认值：base-multilingual-rerank。取值：base-multilingual-rerank / m3-v2-rerank。 *说明 *仅在 rerank_switch 为 true 时生效。 *base-multilingual-rerank（推荐）：速度快、长文本、支持 70+ 种语言。 *m3-v2-rerank：常规文本、支持 100+ 种语言。 *rerank_only_chunk boolean | 仅切片重排 *response.created.response.tools.ranking_options.rerank_only_chunk *是否仅根据 chunk 内容计算重排分数。true 只根据 chunk 内容计算分；false 根据 chunk title + 内容一起计算排序分。 *rerank_switch boolean | 开启重排 *response.created.response.tools.ranking_options.rerank_switch *是否自动对检索结果做 rerank。若设置为 true，则会自动请求 rerank 模型排序。 *retrieve_count integer | 重排切片数 *response.created.response.tools.ranking_options.retrieve_count *进入重排的切片数量。 *注意 *仅在 rerank_switch 为 true 时生效。 *retrieve_count 需要大于等于 limit，否则会抛出错误。 *豆包助手 object *豆包助手工具，让模型使用豆包的聊天、深度思考、AI 搜索和推理搜索能力。 * * * *feature object | 功能配置 *response.created.response.tools.feature *豆包助手的子功能配置，用于按需开启聊天、深度思考、AI 搜索、推理搜索四类能力并设置对应角色描述。 * * * * *ai_search object | AI 搜索 *response.created.response.tools.feature.ai_search *AI 搜索功能配置。 * * *role_description string | 角色描述 *response.created.response.tools.feature.ai_search.role_description *使用豆包助手时修改角色设定。默认值：你的名字是豆包,有很强的专业性。 *注意 *此字段与 system prompt、instructions 互斥，同时配置时以本字段为准。 *type string | 开关 *response.created.response.tools.feature.ai_search.type *功能开关。可选值：enabled、disabled。 *chat object | 普通聊天 *response.created.response.tools.feature.chat *普通聊天功能配置。 * * *role_description string | 角色描述 *response.created.response.tools.feature.chat.role_description *使用豆包助手时修改角色设定。默认值：你的名字是豆包,有很强的专业性。 *注意 *此字段与 system prompt、instructions 互斥，同时配置时以本字段为准。 *type string | 开关 *response.created.response.tools.feature.chat.type *功能开关。可选值：enabled、disabled。 *deep_chat object | 深度聊天 *response.created.response.tools.feature.deep_chat *深度聊天功能配置。 * * *role_description string | 角色描述 *response.created.response.tools.feature.deep_chat.role_description *使用豆包助手时修改角色设定。默认值：你的名字是豆包,有很强的专业性。 *注意 *此字段与 system prompt、instructions 互斥，同时配置时以本字段为准。 *type string | 开关 *response.created.response.tools.feature.deep_chat.type *功能开关。可选值：enabled、disabled。 *reasoning_search object | 推理搜索 *response.created.response.tools.feature.reasoning_search *推理搜索功能配置。 * * *role_description string | 角色描述 *response.created.response.tools.feature.reasoning_search.role_description *使用豆包助手时修改角色设定。默认值：你的名字是豆包,有很强的专业性。 *注意 *此字段与 system prompt、instructions 互斥，同时配置时以本字段为准。 *type string | 开关 *response.created.response.tools.feature.reasoning_search.type *功能开关。可选值：enabled、disabled。 *type string | 类型 *response.created.response.tools.type *工具类型，此处固定为 doubao_app *user_location object | 用户位置 *response.created.response.tools.user_location *用户地理位置信息，用于搜索优化。 * * * * * *type string | 类型 *response.created.response.tools.user_location.type *位置类型。 *取值固定为 approximate。 *city string | 城市 *response.created.response.tools.user_location.city *用户所在城市。 *country string | 国家 *response.created.response.tools.user_location.country *用户所在国家。 *region string | 地区 *response.created.response.tools.user_location.region *用户所在地区。 *timezone number | 时区 *response.created.response.tools.user_location.timezone *用户所在时区。 *top_p number | 采样阈值 *response.created.response.top_p *本次请求实际使用的核采样概率阈值。 *usage object | 用量统计 *response.created.response.usage *本次响应的 token 用量统计，包含输入、输出与总计 token 数等明细。 * * * * * * * *input_tokens integer | 输入 token 数 *response.created.response.usage.input_tokens *输入消耗的 token 数量。 *input_tokens_details object | 输入明细 *response.created.response.usage.input_tokens_details *输入 token 用量明细。 * * * *cached_tokens integer | 缓存 token *response.created.response.usage.input_tokens_details.cached_tokens *命中缓存的 token 数量。 *audio_cached_tokens integer | 音频缓存 Token 数 *response.created.response.usage.input_tokens_details.audio_cached_tokens *缓存命中的音频输入内容所消耗的 token 数量。仅在隐式缓存模式且命中音频缓存时返回；开启显式缓存时该字段不返回。 *audio_tokens integer | 音频 token *response.created.response.usage.input_tokens_details.audio_tokens *音频输入消耗的 token 数量。 *output_tokens integer | 输出 token 数 *response.created.response.usage.output_tokens *输出消耗的 token 数量。 *output_tokens_details object | 输出明细 *response.created.response.usage.output_tokens_details *输出 token 用量明细。 * *reasoning_tokens integer | 思考 token *response.created.response.usage.output_tokens_details.reasoning_tokens *深度思考消耗的 token 数量。 *total_tokens integer | 总 token 数 *response.created.response.usage.total_tokens *本次请求消耗的 token 总数。 *tool_usage object | 工具用量 *response.created.response.usage.tool_usage *工具调用用量统计。 * * * * *doubao_app integer | 豆包次数 *response.created.response.usage.tool_usage.doubao_app *豆包助手工具调用次数。 *knowledge_search integer | 知识库次数 *response.created.response.usage.tool_usage.knowledge_search *知识库搜索工具调用次数。 *mcp integer | MCP 次数 *response.created.response.usage.tool_usage.mcp *MCP 工具调用次数。 *web_search integer | 搜索次数 *response.created.response.usage.tool_usage.web_search *联网搜索工具调用次数。 *tool_usage_details object | 工具明细 *response.created.response.usage.tool_usage_details *工具调用用量明细。 * * * * *doubao_app object | 豆包明细 *response.created.response.usage.tool_usage_details.doubao_app *豆包助手工具用量明细。 *knowledge_search object | 知识库明细 *response.created.response.usage.tool_usage_details.knowledge_search *知识库搜索工具用量明细。 *mcp object | MCP 明细 *response.created.response.usage.tool_usage_details.mcp *MCP 工具用量明细。 *web_search object | 搜索明细 *response.created.response.usage.tool_usage_details.web_search *联网搜索工具用量明细。