本文へスキップ
HopBase ドキュメント
ログイン

画像生成タスクを照会

GPT Image / Gemini の非同期画像生成タスク（`Prefer: respond-async`）のステータスと結果をポーリングします。

GET/v1/images/tasks

画像を生成または画像を編集で Prefer: respond-async を付けると、すぐに 202 と task_id が返るので、このエンドポイントで照会します。タスク ID はクエリパラメータ task_id にのみ指定でき、パスには入れられません。

ステータスは pending / processing / retrying の順に進み、終了状態は completed と failed です。完了後は result_content を読み取ります：画像 1 枚につき 1 行の ![image](/assets-runtime/…) という相対パスで、先頭に https://api.hop-base.com を付ければアクセスできます。このアドレスはキーなしで開けます。公開共有はせず、完了後はできるだけ早く自分のストレージにダウンロードしてください。長期保存先として使わないでください。

生成時に初めて判明する問題（Gemini の参照画像のダウンロード失敗、モデルの応答拒否など）はタスクを失敗させます。この場合は error 文字列のみが返り、エラーコードはありません。送信時には残高が 0 より大きいかだけを確認し、金額の引当は行いません。終了状態になると usage に実際の課金額が示され、タスクを作成したキーからのみ参照できます。

Kling と Midjourney の画像生成はここを使わず、動画タスクを照会を使います。

ヘッダー

Authorization:必須string

Bearer sk-…：コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

クエリパラメーター

task_id:必須string

送信時に返された task_id

長さ≥ 1 文字

レスポンス

200タスクオブジェクト（失敗したタスクを含む）

task_id:必須string

タスク ID

status:必須string

pending / processing / retrying は処理中、completed / failed は終了状態

取りうる値pendingprocessingretryingcompletedfailed

result_content:任意string

完了後の結果：Markdown で、画像 1 枚につき 1 行の ![image](/assets-runtime/…)。アドレスは相対パスなので、https://api.hop-base.com を先頭に付けてアクセスします。キーなしで開けるため、公開共有はせず、できるだけ早くダウンロードして保存してください

error:任意string

失敗理由（英語の文字列、エラーコードなし）。failed のときのみ

usage:任意object

タスクが completed または failed になると表示され、タスクを作成したキーからのみ参照できます

エラー

401キー未指定、キーが無効または期限切れ（missing_api_key / invalid_api_key / api_key_expired）

関連ページ