レスポンスを作成 (OpenAI Responses API)

OpenAI Responses API、モデルのレスポンスを作成するために使用します。 マルチターン対話、ツール呼び出し、推論などの機能をサポートしています。

OpenAI Responses API の画像生成非同期ユースケースを補足します。background=true はバックグラウンドタスクの送信用です。作成 API はすぐに status=queued と完全な id を返し、その後この id を使って GET /v1/responses/{response_id} を呼び出し、結果を照会します。

非同期画像生成フロー

1. POST /v1/responses を呼び出し、リクエストボディに tools=[{ "type": "image_generation" }] と background=true を指定します。
2. 作成 API が返す完全な 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
}

作成 API のレスポンス例：

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