Responses 格式

使用 OpenAI 官方 Responses API 格式创建模型响应。

该接口仅支持 OpenAI 官方 Responses API 支持的模型。请不要把 Claude、DeepSeek 或其他仅支持 Chat Completions / Messages 格式的模型放到此接口。

Try It

POST/v1/responseshttps://api-platform.ope.ai

认证

使用 Bearer Token 认证。

• Header：Authorization: Bearer <api-key>
• 示例：Authorization: Bearer sk-xxxxxx

请求体（application/json）

字段	类型	必填	说明
model	string	是	模型 ID
input	string | array	是	输入内容；可传字符串，也可传 Responses 官方 input item 数组
instructions	string	否	插入到模型上下文中的系统或开发者指令
max_output_tokens	integer	否	响应可生成的最大 token 数
previous_response_id	string	否	上一次响应 ID，用于延续上下文
stream	boolean	否	是否使用 SSE 流式响应
temperature	number	否	采样温度
top_p	number	否	nucleus sampling 参数
tools	array	否	Responses 官方工具数组
tool_choice	string | object	否	工具选择策略
parallel_tool_calls	boolean	否	是否允许并行工具调用
reasoning	object	否	推理模型参数，例如 effort、summary
text	object	否	文本输出配置
truncation	string	否	上下文截断策略
metadata	object	否	元数据
include	array	否	指定响应中额外包含的官方字段
store	boolean	否	是否存储响应
user	string	否	终端用户标识
max_tool_calls	integer	否	本次响应允许的最大工具调用数

请求示例

cURL

curl -X POST "https://api-platform.ope.ai/v1/responses" \
  -H "Authorization: Bearer $OPEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "input": "用一句话介绍 OPEAI Platform。"
  }'

JavaScript

const res = await fetch("https://api-platform.ope.ai/v1/responses", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.OPEAI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-5",
    input: "用一句话介绍 OPEAI Platform。",
  }),
});

console.log(await res.json());

Python

import os
import requests

resp = requests.post(
    "https://api-platform.ope.ai/v1/responses",
    headers={"Authorization": f"Bearer {os.environ['OPEAI_API_KEY']}"},
    json={
        "model": "gpt-5",
        "input": "用一句话介绍 OPEAI Platform。",
    },
    timeout=60,
)

print(resp.json())

input 数组示例

{
  "model": "gpt-5",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "用一句话介绍 OPEAI Platform。"
        }
      ]
    }
  ]
}

响应示例

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1762499410,
  "status": "completed",
  "model": "gpt-5",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "OPEAI Platform 是一个统一接入多种 AI 模型能力的 API 平台。",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 22,
    "total_tokens": 40
  }
}

官方参考：OpenAI Responses API