Skip to content

GET /v1/images/generations/:id

查询图片生成任务状态和结果。适用于上游以异步任务形式返回的图片模型,例如 Seedream、GPT Image、Gemini Image 等兼容任务。

请求

内容
方法GET
路径/v1/images/generations/:id
鉴权API Key 或登录 JWT

Header 参数

参数必填说明
AuthorizationBearer sk-...Bearer <jwt>
x-api-key可替代 Authorization

Path 参数

参数必填类型说明
idstring本地任务 ID。

Query 参数

参数必填说明
key可替代 Header。

返回值

返回兼容任务对象;如果结果中能提取图片 URL,后端会额外在顶层返回 url

json
{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "status": "succeeded",
  "cost": "0.12",
  "url": "https://example.com/image.png",
  "result": {},
  "upstream_id": "provider-task-id",
  "upstream_response": {}
}

基于 MIT 协议发布(社区版)