查询异步图片任务

使用提交任务时所属用户的 Token 查询。任务不存在和无权访问都会返回相同的 HTTP 404。

GET/v1/images/generations/tasks/{task_id}

路径参数

参数	类型	必填	说明
task_id	string	是	提交任务返回的任务 ID

请求示例

cURL

curl --request GET \
  'https://revora.vip/v1/images/generations/tasks/YOUR_TASK_ID' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

JavaScript

const taskId = 'YOUR_TASK_ID';
const response = await fetch(
  `https://revora.vip/v1/images/generations/tasks/${encodeURIComponent(taskId)}`,
  { headers: { Authorization: `Bearer ${process.env.REVORA_API_TOKEN}` } },
);
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

Python

import os
import requests

task_id = "YOUR_TASK_ID"
response = requests.get(
    f"https://revora.vip/v1/images/generations/tasks/{task_id}",
    headers={"Authorization": f"Bearer {os.environ['REVORA_API_TOKEN']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

处理中响应

{
  "success": true,
  "data": {
    "task_id": "img_task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "in_progress",
    "progress": 10,
    "created_at": 1784019600,
    "started_at": 1784019602
  }
}

progress 仅供参考，请始终以 status 判断任务是否完成。

成功响应

{
  "success": true,
  "data": {
    "task_id": "img_task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "succeeded",
    "created_at": 1784019600,
    "started_at": 1784019602,
    "completed_at": 1784019766,
    "result": {
      "created": 1784019766,
      "data": [{ "url": "https://signed-result-url.example/image.png" }]
    }
  }
}

图片地址位于 data.result.data[].url。单次查询生成的签名 URL 有效期为 1 小时，请及时下载；如果 URL 失效，可在结果仍被保留期间重新查询任务获取新地址。

失败响应

任务执行失败时，查询接口通常仍返回 HTTP 200，并在任务数据中返回终态 failed：

{
  "success": true,
  "data": {
    "task_id": "img_task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "failed",
    "completed_at": 1784019766,
    "error": {
      "code": "upstream_error",
      "message": "image generation failed"
    }
  }
}

客户端遇到 failed 后应停止轮询，并记录 task_id、error.code 和 error.message。

兼容查询地址

GET /v1/images/generations/{task_id} 返回相同结构。新接入统一使用带 /tasks/ 的规范地址。