任务查询

查询任务

GET /v1/tasks/{id}

返回的任务对象：

字段	说明
id	任务 ID
capability	能力，如 image.pose
status	状态，见下表
template_id	使用的模板
idempotency_key	创建时传入的 Idempotency-Key，未传为 null
cost	本次任务的点数（成功后实际扣除），见计费与点数
output	成功时有值：{ "images": [图片地址] }
error	失败时有值：{ "code", "message" }
created_at / started_at / finished_at	创建、开始、结束时间（UTC）

状态	含义
queued	排队中
running	生成中
succeeded	成功
failed	失败

建议每 3～5 秒查询一次，直到状态为 succeeded 或 failed。任务超过 15 分钟未完成会被判定为失败。

结果图片会定期清理，请及时下载保存。

任务列表

GET /v1/tasks?page=1&pageSize=20&status=succeeded

{ "data": [], "total": 42, "page": 1, "page_size": 20 }