Retrieve task
画像 / gpt-image-2
画像タスクを取得
画像生成タスクのステータスと結果を照会します。
GET
Retrieve task
非同期画像タスクを送信した後、
task_id を使用してタスクのステータスを照会します。新規実装では /v1/tasks/{task_id} を優先して使用してください。
リクエスト
処理中のレスポンス
成功時のレスポンス
画像 URL の形式
タスクが成功したらresult.data[].url を読み取ります。このフィールドには、相対パス、完全な HTTP(S) URL、または data:image/...;base64,... 形式の Data URL が入る場合があります。
Data URL はエラーでもログ内容でもなく、画像データそのものです。Web ページではそのまま表示できます。スクリプトでファイルとして保存する場合は、先に base64 をデコードしてください。
失敗時のレスポンス
ステータス
| ステータス | 意味 | 呼び出し元での推奨対応 |
|---|---|---|
queued | 処理待ち | ポーリングを続けます。 |
in_progress | 生成中 | ポーリングを続けます。 |
succeeded | 完了 | result.data[].url を表示します。 |
failed | 失敗 | エラー情報を表示し、ユーザーが再試行できるようにします。 |
旧エンドポイント
GET /v1/images/tasks/{task_id} は旧クライアント向けに維持されています。新規実装では 2 種類の照会構造を混在させないでください。
旧エンドポイントのレスポンス例:
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.