跳到正文
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：每張圖一行 ![image](/assets-runtime/…) 的相對路徑，拼上 https://api.hop-base.com 即可存取。該位址無需金鑰即可開啟，請勿公開分享，並在完成後儘快下載到自己的儲存，不要當作長期儲存。

只有生成時才發現的問題（如 Gemini 參考圖下載失敗、模型拒答）會讓任務失敗，此時只回傳 error 字串，沒有錯誤碼。提交時只檢查餘額是否大於 0，不做金額預留；終態後 usage 給出實際扣費，僅建立任務的金鑰可見。

可靈與 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，每張圖一行 ![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）

相關頁面