查詢生圖任務
輪詢 GPT Image / Gemini 非同步生圖任務(`Prefer: respond-async`)的狀態與結果。
/v1/images/tasks生成圖片或編輯圖片帶 Prefer: respond-async 時立即回傳 202 與 task_id,再用本端點查詢。任務 ID 只能放在查詢參數 task_id 裡,不支援放進路徑。
狀態依次為 pending / processing / retrying,終態是 completed 與 failed。完成後讀 result_content:每張圖一行  的相對路徑,拼上 https://api.hop-base.com 即可存取。該位址無需密鑰即可開啟,請勿公開分享,並在完成後儘快下載到自己的儲存,不要當作長期儲存。
只有生成時才發現的問題(如 Gemini 參考圖下載失敗、模型拒答)會讓任務失敗,此時只回傳 error 字串,沒有錯誤碼。提交時只檢查餘額是否大於 0,不做金額預留;終態後 usage 給出實際扣費,僅建立任務的密鑰可見。
可靈與 Midjourney 生圖不走這裡,用查詢影片任務。
請求標頭
Bearer sk-…:主控台「API 密鑰」中建立的密鑰,所屬分組須包含請求的模型
查詢參數
提交時回傳的 task_id
長度≥ 1 字元
回傳
200任務物件(含失敗任務)
任務 ID
pending / processing / retrying 為進行中,completed / failed 為終態
可選值pendingprocessingretryingcompletedfailed
完成後的結果:Markdown,每張圖一行 。位址是相對路徑,拼上 https://api.hop-base.com 存取;無需密鑰即可開啟,請勿公開分享並儘快下載儲存
失敗原因(英文字串,沒有錯誤碼);僅 failed 時出現
任務 completed 或 failed 後出現,僅建立任務的密鑰可見
本任務扣費的人民幣金額(與 cost_usd 為同一筆扣費);生成失敗通常為 0,扣費結算後才失敗則為實際扣費
本任務實際從餘額扣除的美元金額,與使用記錄相同
cost 的幣種,恆為 CNY
錯誤
missing_api_key / invalid_api_key / api_key_expired)