xmsmartlink Docs

外观

GPT-Image 异步任务查询 ​

查询通过 GPT-Image 异步生图接口创建的本地任务。

适用场景 ​

已经通过 GPT-Image 异步创建接口获得 task_id，需要查询进度、结果或失败原因时使用该接口。

Base URL ​

https://vip.xmsmartlink.com

鉴权 ​

Authorization: Bearer YOUR_API_KEY

Endpoint ​

GET /v1/aigc-images/generations/{task_id}

路径参数 ​

移动端可横向滑动查看完整参数。

参数类型必填说明
task_idstring是创建接口返回的本地异步图片任务 ID。

请求示例 ​

bash
curl -X GET 'https://vip.xmsmartlink.com/v1/aigc-images/generations/imgtask_xxx' \
  -H 'Authorization: Bearer YOUR_API_KEY'

状态与重试 ​

  • queued、processing：任务未完成，等待后再次查询。
  • success：成功终态，从 images[].url 读取结果。
  • failure：失败终态，从 error 读取原因。
  • progress 范围为 0 到 100。
  • 查询请求可在网络错误时安全重试，但应避免过高频率；响应包含 Retry-After 时优先遵守，并且不得低于接口规定的最低查询间隔。
  • 本接口不提供回调能力，不要等待回调，也不要因查询失败重复创建图片任务。

响应说明 ​

字段类型说明
task_idstring任务 ID。
statusstringqueued、processing、success 或 failure。
progressinteger任务进度，范围 0-100。
created_atinteger创建时间戳。
images[].urlstring生成图片 URL。
errorstring失败原因。

响应示例 ​

成功终态：

json
{
  "task_id": "imgtask_xxx",
  "status": "success",
  "progress": 100,
  "created_at": 1776831801,
  "images": [
    {
      "url": "https://example.com/generated.png"
    }
  ]
}

失败终态：

json
{
  "task_id": "imgtask_xxx",
  "status": "failure",
  "progress": 0,
  "created_at": 1776831801,
  "error": "upstream create failed"
}

API Reference ​

查看底层接口定义