创建响应 (OpenAI Responses API)
OpenAI格式(Responses)
创建响应 (OpenAI Responses API)
OpenAI Responses API,用于创建模型响应。 支持多轮对话、工具调用、推理等功能。
补充 OpenAI Responses API 的图片生成异步用例。background=true 用于提交后台任务,创建接口会立即返回 status=queued 和完整 id,随后使用该 id 调用 GET /v1/responses/{response_id} 查询结果。
异步图片生成流程
- 调用
POST /v1/responses,请求体中传tools=[{ "type": "image_generation" }]且background=true。 - 保存创建接口返回的完整
id,例如resp_xxx。不要截断、重写或只保存metadata.task_id。 - 调用
GET /v1/responses/{response_id}查询,直到status=completed或status=failed。 - 成功后读取
output[].url获取图片链接。
创建异步图片任务示例
POST /v1/responses
Content-Type: application/json
{
"model": "gpt-image-2-2k",
"input": "生成一张 2K 横屏产品海报,白色运动鞋,干净棚拍光线,高级商业摄影风格。",
"stream": false,
"tools": [
{
"type": "image_generation"
}
],
"background": true
}
创建接口返回示例:
{
"id": "resp_xxx",
"created_at": 1780649146,
"error": null,
"incomplete_details": null,
"instructions": null,
"metadata": {
"task_id": "010c31178d26436ca6194cde07931b33",
"credits": "23"
},
"model": "gpt-image-2-2k",
"object": "response",
"output": [],
"parallel_tool_calls": true,
"temperature": null,
"tool_choice": null,
"tools": null,
"top_p": null,
"max_output_tokens": null,
"previous_response_id": null,
"reasoning": null,
"status": "queued",
"text": null,
"truncation": null,
"usage": null,
"user": null,
"store": null
}
支持模型:gpt-image-2-2k、gpt-image-2-4k、nano-banana-pro。
POST
创建响应 (OpenAI Responses API)
授权
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
请求体
application/json
The body is of type object.
