跳到正文
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）

相关页面