Responses 格式

Responses 格式

OpenAI Responses API,用于创建模型响应。支持多轮对话、工具调用、推理等功能。

字段值
Base URLhttps://token.easyapi.com/v1
认证Authorization: Bearer `API_KEY`
示例模型gpt-4o
格式OpenAI Responses 兼容
计费按量计费
注意: 完整路径为 POST /v1/responses。input 可为字符串或消息数组;可通过 previous_response_id 延续多轮对话。同样支持 usage.include、models 与 provider.sort,见下方请求体说明。

示例模型

下文均以 gpt-4o(GPT-4o)为例;更换其他模型时,请替换 model 参数,并参考控制台模型说明调整 size、quality 等字段。

创建响应

POSThttps://token.easyapi.com/v1/responses

使用 OpenAI Responses API 创建模型响应,支持多轮对话、工具调用与推理。

请求参数

名称位置类型必选说明
Authorizationheaderstring是EasyAPI API Key。格式:Bearer `API_KEY`
Content-Typeheaderstring是请求体格式

请求体

名称类型必选说明
modelstring是模型 ID
inputstring | array<object>否输入内容,可以是字符串或消息数组
instructionsstring否系统级指令,影响模型行为
max_output_tokensinteger否最大输出 Token 数
temperaturenumber否采样温度
top_pnumber否核采样参数
streamboolean否是否流式响应
toolsarray<object>否可调用的工具定义列表
tool_choicestring | object否工具选择策略,字符串或对象
reasoningobject否推理相关配置
previous_response_idstring否上一轮响应 ID,用于多轮对话
truncationstring否截断策略:auto
usageobject否设为 usage.include = true 时,响应的 usage 对象会多一个 cost 字段(本次调用费用,USD);流式请求在最后一个带 usage 的块里返回。最终扣费以 GET /v1/generation 为准
modelsarray<string>否回退模型序列(最多 5 个)。主模型没有可用渠道,或上游失败且尚未开始输出时,按顺序换用下一个模型重试;仅限本 Key 允许的模型
providerobject否同优先级渠道内的路由偏好:provider.sort 取 price 选最便宜的渠道;latency 选实测首字延迟最低的(非流式按端到端耗时);throughput 选实测输出 tokens/s 最高的。latency 与 throughput 用该模型在各渠道的真实请求实测,没有实测数据时退回渠道测速。模型名后缀 :floor 等价 sort=price,:nitro 等价 sort=throughput

示例

{
  "model": "gpt-4o",
  "input": "Hello!",
  "instructions": "You are a helpful assistant.",
  "max_output_tokens": 1024,
  "usage": {
    "include": true
  }
}

返回示例

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1718452800,
  "status": "completed",
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Hello! How can I help you today?"
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 12,
    "total_tokens": 27,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 15,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 12,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    },
    "cost": 0.0000875
  }
}