建立回應 (OpenAI Responses API)

OpenAI Responses API，用於建立模型回應。 支援多輪對話、工具呼叫、推理等功能。

補充 OpenAI Responses API 的圖片生成非同步用例。background=true 用於提交背景任務，建立介面會立即回傳 status=queued 和完整 id，隨後使用該 id 呼叫 GET /v1/responses/{response_id} 查詢結果。

非同步圖片生成流程

1. 呼叫 POST /v1/responses，請求體中傳入 tools=[{ "type": "image_generation" }] 且 background=true。
2. 保存建立介面回傳的完整 id，例如 resp_xxx。不要截斷、重寫或只保存 metadata.task_id。
3. 呼叫 GET /v1/responses/{response_id} 查詢，直到 status=completed 或 status=failed。
4. 成功後讀取 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。