文档

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 延续多轮对话。

示例模型

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

创建响应

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

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

请求参数

名称位置类型必选说明
AuthorizationheaderstringEasyAPI API Key。格式:Bearer `API_KEY`
Content-Typeheaderstring请求体格式,固定 application/json

请求体

名称类型必选说明
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

示例

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

响应示例

{
  "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
    }
  }
}