创建 Responses 请求 (OpenAI)

简介

Responses API 是 OpenAI 推出的新一代对话接口，专为推理模型（o 系列、GPT-5 系列）和高级功能设计。相比传统的 Chat Completions API，Responses API 提供了更精细的推理控制、内置工具支持和多模态输入能力。

适用场景

推理密集型任务：使用 o1、o3-mini、o4-mini、GPT-5 等推理模型
需要联网搜索：内置 Web Search Preview 工具
高级工具调用：支持 Function Call 和 Custom Tool Call
多轮对话延续：通过 previous_response_id 实现对话历史管理

认证

Bearer Token，如 Bearer sk-xxxxxxxxxx

请求参数

model

string

required

模型标识，如 gpt-5.2、o4-mini、o3-mini

input

array

required

输入消息列表

max_output_tokens

integer

最大输出 token 数

stream

boolean

是否启用流式输出

reasoning

object

推理配置，如 {"effort": "high", "summary": "detailed"}

tools

array

工具列表，支持 Web Search 和函数调用

previous_response_id

string

上一条响应的 ID，用于延续对话

基础示例

简单对话（非流式）
简单对话（流式）
Python SDK

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "max_output_tokens": 2048,
    "input": [
      {"role": "user", "content": "请用中文简要介绍人工智能"}
    ]
  }'

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "stream": true,
    "max_output_tokens": 2048,
    "input": [
      {"role": "user", "content": "请用中文简要介绍人工智能"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://console.mixroute.io/v1"
)

# 非流式调用
response = client.responses.create(
    model="gpt-5.2",
    max_output_tokens=2048,
    input=[
        {"role": "user", "content": "请用中文简要介绍人工智能"}
    ]
)

print(response.output[0].content[0].text)

# 流式调用
stream = client.responses.create(
    model="gpt-5.2",
    stream=True,
    max_output_tokens=2048,
    input=[
        {"role": "user", "content": "请用中文简要介绍人工智能"}
    ]
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

高级功能

联网搜索（Web Search）

基础示例
高级配置

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "stream": true,
    "input": [
      {"role": "user", "content": "今天的新闻头条是什么？"}
    ],
    "tools": [
      {
        "type": "web_search_preview"
      }
    ]
  }'

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "stream": true,
    "input": [
      {"role": "user", "content": "搜索最新的人工智能研究进展"}
    ],
    "tools": [
      {
        "type": "web_search_preview",
        "search_context_size": "high",
        "user_location": {
          "type": "approximate",
          "country": "CN"
        }
      }
    ]
  }'

配置说明：

search_context_size: 搜索上下文大小，可选 low、medium、high
user_location: 用户位置，影响搜索结果的地区相关性

推理控制（Reasoning）

自动推理摘要
详细推理过程

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "o4-mini",
    "stream": true,
    "reasoning": {
      "effort": "medium",
      "summary": "auto"
    },
    "max_output_tokens": 4096,
    "input": [
      {"role": "user", "content": "计算 1+2+3+...+100 的和"}
    ]
  }'

说明： summary: "auto" 会自动生成推理摘要，适合快速获取结果。

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "o4-mini",
    "stream": true,
    "reasoning": {
      "effort": "high",
      "summary": "detailed"
    },
    "max_output_tokens": 8192,
    "input": [
      {"role": "user", "content": "证明根号2是无理数"}
    ]
  }'

推理配置参数：

effort: 推理强度，可选 low、medium、high
summary: 摘要模式，可选 auto、concise、detailed

自定义函数调用

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "input": [
      {"role": "user", "content": "北京今天天气怎么样？"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "获取指定城市的天气信息",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {
                "type": "string",
                "description": "城市名称"
              },
              "unit": {
                "type": "string",
                "enum": ["celsius", "fahrenheit"],
                "description": "温度单位"
              }
            },
            "required": ["city"]
          }
        }
      }
    ],
    "tool_choice": "auto"
  }'

多模态输入

图片输入
文件输入

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "这张图片里有什么？"
          },
          {
            "type": "input_image",
            "image_url": "https://console.mixroute.io/demo/sample-image.jpg"
          }
        ]
      }
    ]
  }'

curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "请总结这份文档的主要内容"
          },
          {
            "type": "input_file",
            "file_id": "file-xxxxxxxx"
          }
        ]
      }
    ]
  }'

使用文件输入前，需要先通过 Files API 上传文件获取 file_id。

对话延续

通过 previous_response_id 实现多轮对话的上下文延续：

# 第一轮对话
curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "input": [
      {"role": "user", "content": "我叫小明，请记住我的名字"}
    ]
  }'

# 响应中会返回 id: "resp_abc123"

# 第二轮对话（延续上下文）
curl -X POST "https://console.mixroute.io/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "model": "gpt-5.2",
    "previous_response_id": "resp_abc123",
    "input": [
      {"role": "user", "content": "我叫什么名字？"}
    ]
  }'

响应格式

非流式响应
流式响应（SSE 事件）

{
  "id": "resp_xxx",
  "object": "response",
  "created_at": 1709123456,
  "model": "gpt-5.2",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "人工智能（Artificial Intelligence，简称AI）是计算机科学的一个分支..."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "total_tokens": 175
  }
}

流式响应使用 Server-Sent Events (SSE) 格式返回：

event: response.created
data: {"type":"response.created","response":{"id":"resp_xxx","status":"in_progress"}}

event: response.output_item.added
data: {"type":"response.output_item.added","output_index":0,"item":{"type":"message","role":"assistant"}}

event: response.content_part.added
data: {"type":"response.content_part.added","part":{"type":"output_text","text":""}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"人工"}

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"智能"}

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"是..."}

event: response.output_text.done
data: {"type":"response.output_text.done","text":"人工智能是..."}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_xxx","status":"completed","usage":{"input_tokens":25,"output_tokens":150}}}

常见 SSE 事件类型：

事件类型	说明
`response.created`	响应创建
`response.output_text.delta`	文本增量输出
`response.output_text.done`	文本输出完成
`response.completed`	响应完成
`response.failed`	响应失败

对比：Responses API vs Chat Completions API

特性	Responses API	Chat Completions API
推理模型支持	✅ 完整支持	⚠️ 有限支持
内置 Web Search	✅ 原生支持	❌ 不支持
推理控制	✅ 精细控制	❌ 不支持
对话延续	✅ `previous_response_id`	❌ 需手动管理
多模态输入	✅ 完整支持	✅ 支持
适用场景	推理、搜索、高级功能	通用对话

curl --request POST \
  --url https://console.mixroute.io/v1/responses \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.2",
    "max_output_tokens": 2048,
    "input": [
      {"role": "user", "content": "请用中文简要介绍人工智能"}
    ]
  }'

{
  "id": "resp_xxx",
  "object": "response",
  "created_at": 1768271369,
  "model": "gpt-5.2",
  "status": "completed",
  "output": [
    {
      "id": "msg_xxx",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "人工智能（AI）是计算机科学的一个分支...",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "total_tokens": 175
  }
}

当下热门模型

OpenAI 官方库使用

文本系列

文本向量系列

图像系列

视频系列

其他

创建 Responses 请求 (OpenAI)

简介

适用场景

认证

请求参数

基础示例

高级功能

联网搜索（Web Search）

推理控制（Reasoning）

自定义函数调用

多模态输入

对话延续

响应格式

对比：Responses API vs Chat Completions API

当下热门模型

OpenAI 官方库使用

文本系列

文本向量系列

图像系列

视频系列

其他

​简介

​适用场景

​认证

​请求参数

​基础示例

​高级功能

​联网搜索（Web Search）

​推理控制（Reasoning）

​自定义函数调用

​多模态输入

​对话延续

​响应格式

​对比：Responses API vs Chat Completions API

简介

适用场景

认证

请求参数

基础示例

高级功能

联网搜索（Web Search）

推理控制（Reasoning）

自定义函数调用

多模态输入

对话延续

响应格式

对比：Responses API vs Chat Completions API