简体中文

English

简体中文

English

主题

多模态响应接口 ​

使用 OpenAI Responses API 格式创建响应，支持多模态输入、工具调用、流式输出和上下文压缩。

http
POST /v1/responses

Responses API 面向多模态、工具调用和上下文续接。相比 对话接口（Chat Completions），输入 / 输出与工具调用结构更适合复杂任务编排。

默认模型为 。

当前可用模型 ​

模型说明
旗舰 5.6 系列最新
高规格 5.5 系列
通用 5.4 系列
轻量版 5.4
代码专项 5.3
更小规格 5 系列
通用多模态模型
通用文本 / 工具调用模型

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例：
string是请求内容类型，必须设置为

请求体 ​

名称类型必填说明
string是模型名称，默认示例 ；可选值见上方「当前可用模型」
string | array否模型输入：纯文本字符串，或文本 / 图片 / 文件等输入项数组
string否系统（开发者）消息；与 联用时不会自动继承上一轮
object否推理配置，适用于 o 系列与 gpt-5 系列
object否文本输出配置（、）
array否可调用工具列表（内置 / MCP / function）
string | object否工具选择： / / ，或指定工具对象
boolean否是否允许并行工具调用，默认
integer否单次响应生成 token 上限（含可见输出与推理 token），最小
integer否单次响应内置工具调用总次数上限
number否采样温度，范围 –，默认
number否核采样，范围 –，默认
integer否–，返回候选 token 对数概率数量
boolean否是否 SSE 流式输出，默认
object否流式选项，仅 时生效
boolean否是否后台异步执行，默认
boolean否是否存储响应以便后续检索，默认
object否最多 16 组键值对元数据
array否额外包含的输出数据（如检索结果、logprobs 等）
string否已废弃。截断策略： / （默认）
string否上一轮响应 ID，用于多轮续接；不可与 同用
string | object否会话 ID 或 ；不可与 同用
object否可复用提示词模板（ / / ）
string否提示词缓存分桶键
object否缓存选项（、）；gpt-5.6 及之后支持
string否终端用户稳定标识，最长 64 字符
string否处理层级： / / / / /
string否已废弃，请用 /
object否内容审核配置
array否超长上下文管理配置

reasoning ​

名称类型必填说明
string否 / / / / / / ，默认
string否 / /

text ​

名称类型必填说明
object否默认 ；可用 /
string否 / / ，默认

stream_options ​

名称类型必填说明
boolean否流混淆字段；信任链路可关以省带宽。用量默认在 返回

prompt ​

名称类型必填说明
string是提示词模板 ID
string否模板版本
object否模板变量

请求示例 ​

bash
curl -X POST https://octopusx.ai/v1/responses \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "instructions": "你是一个简洁的技术助手。",
    "input": "用三句话解释 Responses API 适合什么场景。"
  }'
bash
curl -X POST https://octopusx.ai/v1/responses \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": [
      {
        "type": "input_text",
        "text": "描述这张图片里的主要内容。"
      },
      {
        "type": "input_image",
        "image_url": "https://example.com/image.png"
      }
    ]
  }'
bash
curl -X POST https://octopusx.ai/v1/responses \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": "查询杭州今天的天气。",
    "tools": [
      {
        "type": "function",
        "name": "get_weather",
        "description": "按城市查询天气",
        "parameters": {
          "type": "object",
          "properties": {
            "city": { "type": "string" }
          },
          "required": ["city"]
        }
      }
    ],
    "tool_choice": "auto"
  }'
bash
curl -X POST https://octopusx.ai/v1/responses \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": "逐步说明 Responses API 的优势。",
    "stream": true
  }'

响应示例 ​

json
{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1735689600,
  "status": "completed",
  "model": "gpt-5.6-terra",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Responses API 适合多模态输入、工具调用和需要上下文续接的任务。它把输出拆成结构化 item，便于程序读取。通过统一网关可以复用同一套认证、计费和渠道分发能力。",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 62,
    "total_tokens": 88
  }
}

响应字段 ​

名称类型说明
string响应 ID
string固定为
integer创建时间戳（秒）
string状态，如
string实际使用的模型
array结构化输出项列表
string输出项类型，如
array内容片段（如 ）
objecttoken 用量
integer输入 token
integer输出 token
integer总 token

上下文压缩 ​

POST /v1/responses/compact 将较长上下文压缩为后续可续接的摘要。请求结构接近 /v1/responses，常用字段为 model、input、instructions、previous_response_id。

bash
curl -X POST https://octopusx.ai/v1/responses/compact \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "instructions": "压缩成后续对话可继续使用的上下文，保留决策、约束和待办。",
    "input": [
      { "role": "user", "content": "第一轮需求..." },
      { "role": "assistant", "content": "第一轮方案..." }
    ]
  }'

注意事项 ​

TIP

可选参数是否生效取决于实际上游模型能力。调试台中非必填字段默认关闭，打开开关后才会写入请求体。

WARNING

previous_response_id 与 conversation 不能同时使用。流式用量通常通过 response.completed 事件返回。

相关接口 ​