Responses 格式
OpenAI Responses API,用于创建模型响应。支持多轮对话、工具调用、推理等功能。
注意: 完整路径为 POST /v1/responses。input 可为字符串或消息数组;可通过 previous_response_id 延续多轮对话。
示例模型
下文均以 gpt-4o(GPT-4o)为例;更换其他模型时,请替换 model 参数,并参考控制台模型说明调整 size、quality 等字段。
创建响应
POST
https://token.easyapi.com/v1/responses使用 OpenAI Responses API 创建模型响应,支持多轮对话、工具调用与推理。
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
Authorization | header | string | 是 | EasyAPI API Key。格式:Bearer `API_KEY` |
Content-Type | header | string | 是 | 请求体格式,固定 application/json |
请求体
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID |
input | string | array<object> | 否 | 输入内容,可以是字符串或消息数组 |
instructions | string | 否 | 系统级指令,影响模型行为 |
max_output_tokens | integer | 否 | 最大输出 Token 数 |
temperature | number | 否 | 采样温度 |
top_p | number | 否 | 核采样参数 |
stream | boolean | 否 | 是否流式响应 |
tools | array<object> | 否 | 可调用的工具定义列表 |
tool_choice | string | object | 否 | 工具选择策略,字符串或对象 |
reasoning | object | 否 | 推理相关配置 |
previous_response_id | string | 否 | 上一轮响应 ID,用于多轮对话 |
truncation | string | 否 | 截断策略: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
}
}
}