Skip to main content
POST
/
v1
/
responses
curl -X POST https://www.geeknow.top/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "instructions": "你是一个简洁的技术助手。",
    "input": "用三句话解释 Responses API 适合什么场景。"
  }'

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1735689600,
  "status": "completed",
  "model": "gpt-4o",
  "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
  }
}

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
OpenAI 多模态响应接口

Responses API 是面向多模态、工具调用和上下文续接的统一响应接口。相比 Chat Completions，它的输入、输出和工具调用结构更适合复杂任务编排。

​
请求体

​
model
string
required
模型名称。
​
input
string | array<object>
用户输入。可以是字符串，也可以是结构化消息数组。
​
instructions
string
开发者或系统级指令。
​
previous_response_id
string
上一轮响应 ID。上游支持时可用于上下文续接。
​
tools
array<object>
工具列表。支持函数工具，也可转发上游兼容的内置工具。
​
tool_choice
string | object
工具选择策略。
​
max_output_tokens
integer
最大输出 token 数。显式传 0 会被保留并转发给支持的上游。
​
reasoning
object
推理配置，例如 { "effort": "medium", "summary": "auto" }。
​
text
object
文本输出配置，常用于 JSON Schema 结构化输出。
​
stream
boolean
是否启用 SSE 流式输出。
​
stream_options.include_usage
boolean
流式响应中是否包含 token 用量。
​
store
boolean
控制上游是否存储请求和响应。该字段默认允许转发，可由渠道设置禁用。
​
metadata
object
业务侧附加元数据。
​
include
array<string>
请求响应中额外包含的字段，具体取值取决于上游实现。

​
请求示例

curl -X POST https://www.geeknow.top/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "instructions": "你是一个简洁的技术助手。",
    "input": "用三句话解释 Responses API 适合什么场景。"
  }'

​
多模态输入

curl -X POST https://www.geeknow.top/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": [
      {
        "role": "user",
        "content": [
          { "type": "input_text", "text": "提取这张截图中的异常指标。" },
          { "type": "input_image", "image_url": "https://example.com/dashboard.png", "detail": "high" }
        ]
      }
    ]
  }'

​
工具调用

curl -X POST https://www.geeknow.top/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "北京今天适合户外跑步吗？",
    "tools": [
      {
        "type": "function",
        "name": "get_weather",
        "description": "获取城市天气",
        "parameters": {
          "type": "object",
          "properties": {
            "city": { "type": "string" }
          },
          "required": ["city"]
        }
      }
    ],
    "tool_choice": "auto"
  }'

​
流式输出

curl -N -X POST https://www.geeknow.top/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "写一个 5 行以内的产品发布公告。",
    "stream": true,
    "stream_options": {
      "include_usage": true
    }
  }'

​
响应示例

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1735689600,
  "status": "completed",
  "model": "gpt-4o",
  "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
  }
}

​
上下文压缩

POST /v1/responses/compact
用于把较长上下文压缩成适合后续继续对话的摘要。请求结构与 /v1/responses 接近，常用字段为 model、input、instructions、previous_response_id。 
curl -X POST https://www.geeknow.top/v1/responses/compact \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "instructions": "压缩成后续对话可继续使用的上下文，保留决策、约束和待办。",
    "input": [
      { "role": "user", "content": "第一轮需求..." },
      { "role": "assistant", "content": "第一轮方案..." }
    ]
  }'

​
相关接口