查询图片任务

GET

images

generations

{task_id}

Error

A valid request URL is required to generate request examples

{
  "id": "img_task_01JXYZEXAMPLE",
  "status": "succeeded",
  "created": 1787600000,
  "data": [
    {
      "url": "https://cdn.example.com/generated/result.png"
    }
  ]
}

{
  "code": "unauthorized",
  "message": "invalid API key"
}

{
  "code": "rate_limit_exceeded",
  "message": "too many requests"
}

当图片生成或编辑接口返回 id 或 task_id 时，使用该值轮询本接口。建议每 2-5 秒查询一次，成功后读取 data[].url 并及时转存。

授权

Authorization

string

header

必填

请求头格式：Authorization: Bearer YOUR_API_KEY

路径参数

task_id

string

必填

图片生成或编辑返回的任务 ID

响应

图片任务状态

string

异步图片任务 ID。

task_id

string

部分实现使用的异步图片任务 ID 字段。

status

enum<string>

可用选项:

queued,

pending,

processing,

running,

succeeded,

completed,

failed,

cancelled,

expired

progress

number

必填范围: 0 <= x <= 100

created

integer

创建 Unix 时间戳，单位秒。

data

object[]

Show child attributes

error

object | null

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "id": "img_task_01JXYZEXAMPLE",
  "status": "succeeded",
  "created": 1787600000,
  "data": [
    {
      "url": "https://cdn.example.com/generated/result.png"
    }
  ]
}

{
  "code": "unauthorized",
  "message": "invalid API key"
}

{
  "code": "rate_limit_exceeded",
  "message": "too many requests"
}

概览

模型

文字系列

图像系列

视频系列

音频系列

上传管理

授权

路径参数

响应