OpenAI Responses API 参考

model string （必选）

模型名称。当前支持 qwen3-max、qwen3-max-2026-01-23、qwen3.5-plus、qwen3.5-plus-2026-02-15、qwen3.5-397b-a17b。

input string 或 array （必选）

模型输入，支持以下格式：

• string：纯文本输入，如 "你好"。

• array：消息数组，按对话顺序排列。

previous_response_id string （可选）

上一个响应的唯一 ID，当前响应id有效期为7天。使用此参数可创建多轮对话，服务端会自动检索并组合该轮次的输入与输出作为上下文。当同时提供 input 消息数组和 previous_response_id 时，input 中的新消息会追加到历史上下文之后。

stream boolean （可选）默认值为 false

是否开启流式输出。设置为 true 时，模型响应数据将实时流式返回给客户端。

tools array （可选）

模型在生成响应时可调用的工具数组。支持内置工具和自定义 function 工具，可混合使用。

为了获得最佳回复效果，建议同时开启 code_interpreter、web_search 和 web_extractor 工具。

mcp_tool = {
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "amap-maps",
    "server_description": "高德地图MCP Server现已覆盖15大核心接口，提供全场景覆盖的地理信息服务，包括生成专属地图、导航到目的地、打车、地理编码、逆地理编码、IP定位、天气查询、骑行路径规划、步行路径规划、驾车路径规划、公交路径规划、距离测量、关键词搜索、周边搜索、详情搜索等。",
    "server_url": "https://dashscope.aliyuncs.com/api/v1/mcps/amap-maps/sse",
    "headers": {
        "Authorization": "Bearer <your-mcp-server-token>"
    }
}

[{
  "type": "function",
  "name": "get_weather",
  "description": "获取指定城市的天气信息",
  "parameters": {
    "type": "object",
    "properties": {
      "city": {
        "type": "string",
        "description": "城市名称"
      }
    },
    "required": ["city"]
  }
}]

tool_choice string or object （可选）默认值为 auto

控制模型如何选择和调用工具。此参数支持两种赋值格式：字符串模式和对象模式。

[
  { "type": "function", "name": "get_weather" }
]

temperature float （可选）

采样温度，控制模型生成文本的多样性。

temperature越高，生成的文本更多样，反之，生成的文本更确定。

取值范围： [0, 2)

temperature与top_p均可以控制生成文本的多样性，建议只设置其中一个值。更多说明，请参见文本生成模型概述。

top_p float （可选）

核采样的概率阈值，控制模型生成文本的多样性。

top_p越高，生成的文本更多样。反之，生成的文本更确定。

取值范围：（0,1.0]

temperature与top_p均可以控制生成文本的多样性，建议只设置其中一个值。更多说明，请参见文本生成模型概述。

enable_thinking boolean （可选）

是否开启思考模式。开启后，模型会在回复前进行思考，思考内容将通过 reasoning 类型的输出项返回。开启思考模式时，建议开启内置工具，以在处理复杂任务时获得最佳的模型效果。

可选值：

• true：开启

• false：不开启

不同模型的默认值：支持的模型

该参数非OpenAI标准参数。Python SDK 通过 extra_body={"enable_thinking": True} 传递；Node.js SDK 和 curl 直接使用 enable_thinking: true 作为顶层参数。

id string

本次响应的唯一标识符，为 UUID 格式的字符串，有效期为7天。可用于 previous_response_id 参数以创建多轮对话。

created_at integer

本次请求的 Unix 时间戳（秒）。

object string

对象类型，固定为 response。

status string

响应生成的状态。枚举值：

• completed：生成完成

• failed：生成失败

• in_progress：生成中

• cancelled：已取消

• queued：请求排队中

• incomplete：生成不完整

model string

用于生成响应的模型 ID。

output array

模型生成的输出项数组。数组中的元素类型和顺序取决于模型的响应。

usage object

本次请求的 Token 消耗信息。

error object

当模型生成响应失败时返回的错误对象。成功时为 null。

tools array

回显请求中 tools 参数的完整内容，结构与请求体中的 tools 参数相同。

tool_choice string

回显请求中 tool_choice 参数的值，枚举值为 auto、none、required。

流式输出返回一系列 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_summary_text.delta：（开启思考模式时）推理摘要增量文本，delta 字段包含新增摘要片段。

• response.reasoning_summary_text.done：（开启思考模式时）推理摘要完成，text 字段包含完整摘要。

• 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.mcp_call_arguments.delta / response.mcp_call_arguments.done：（使用 mcp 工具时）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 事件中为完整对象。

part object

内容块对象。出现在 response.content_part.added 和 response.content_part.done 事件中。

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 数组中的索引位置。

summary_index integer

摘要数组索引。出现在 response.reasoning_summary_text.delta 和 response.reasoning_summary_text.done 事件中。