图片生成（查询状态）

GET /v1/images/generations/:id 参考，涵盖任务状态、生成图片记录、超时处理和任务归属校验。

查询图片生成任务状态，并在任务完成后获取生成的图片。

端点

GET https://api.leaper.one/v1/images/generations/:id

参数

参数	类型	必填	说明
id	string（路径参数）	是	图片生成任务 UUID，由创建任务端点返回

请求

curl https://api.leaper.one/v1/images/generations/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer sk-your-api-key"

响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "completed",
    "images": [
      {
        "id": "image-abc123",
        "url": "https://s3.bitiful.net/leaperone/images/generated/abc123?X-Amz-Expires=3600&..."
      }
    ]
  }
}

状态值

状态	说明
`pending`	任务已进入队列，等待开始
`processing`	正在生成图片
`uploading`	正在把生成的图片上传到存储
`partial`	部分图片已就绪，其他图片仍在处理
`completed`	所有图片都可以下载
`failed`	生成失败，请查看响应中的错误详情

注意事项

每次查询状态时都会重新签名图片 URL，URL 在 1 小时后过期。过期后再次轮询即可获取新 URL。
超过 30 天的任务会被删除。查询已删除的任务会返回 410 Gone。

端点

参数

请求

响应

状态值

注意事项

目录