Skip to main content

任务查询

查询异步任务的状态和结果。图片和视频生成都是异步操作，提交后需要通过此接口轮询获取结果。

查询单个任务​

GET /v1/videos/generations/:task_id

路径参数​

参数说明
task_id提交任务时返回的任务 ID

响应 — 进行中​

{
  "task_id": "1403290248-AigcImageTask-xxxx",
  "status": "running",
  "model": "GEM-3.0",
  "progress": "60%"
}

响应 — 成功​

{
  "task_id": "1403290248-AigcImageTask-xxxx",
  "status": "success",
  "model": "GEM-3.0",
  "created": 1710000000,
  "data": [
    {
      "url": "https://xxx.myqcloud.com/aigcImageGenFile.png"
    }
  ]
}

响应 — 失败​

{
  "task_id": "1403290248-AigcImageTask-xxxx",
  "status": "failed",
  "model": "GEM-3.0",
  "error": {
    "message": "内容违规"
  }
}

status 状态说明​

状态说明
pending任务已提交，等待处理
running正在生成
success生成完成，data[0].url 包含结果 URL
failed生成失败，error.message 包含原因

查询任务列表​

GET /v1/tasks?page=1&page_size=20

返回当前 API Key 的所有任务。

推荐轮询策略​

首次查询：提交后等待 3 秒
图片任务：每 3 秒轮询一次，最长等待 2 分钟
视频任务：每 5 秒轮询一次，最长等待 5 分钟
结果 URL 有效期

生成的图片/视频 URL 为临时地址，有效期约 7 天。请及时下载保存到你自己的存储服务。