查询任务状态
轮询任务直到进入终态并读取生成结果。
GET/api/v1/tasks/:id
每个任务最多每秒轮询一次。终态为 completed、failed、canceled——看到终态即停止轮询。
任务完成后，data.results 是输出文件 URL（带签名、限时有效——请尽快下载），data.media 额外给出每个文件的类型、缩略图和时长。
curl https://vidocraft.com/api/v1/tasks/3f2ak9mr7xqp4tnz8blc6ywh \
-H "Authorization: Bearer sk_test_xxxxxxxx"{
"id": "3f2ak9mr7xqp4tnz8blc6ywh",
"status": "completed",
"created_at": 1781234567,
"model": "text-to-image:rikcgfbufzdm",
"credits": 1,
"billing_status": "charged",
"failed_reason": null,
"data": {
"results": ["https://cdn.example.com/…/output.png"],
"media": [
{ "url": "https://cdn.example.com/…/output.png", "type": "image" }
]
}
}status 取值
| 取值 | 含义 |
|---|---|
queued | 已接受，等待执行槽位。 |
generating | 模型处理中。 |
completed | 已完成——data.results 包含输出 URL。 |
failed | 生成失败，预留积分已退回；failed_reason 为 nsfw_output_blocked 时除外（见下）。 |
canceled | 完成前被取消。排队（queued）时取消，积分会退回；开始生成后取消，积分照常扣除。 |
billing_status 取值
| 取值 | 含义 |
|---|---|
reserved | 任务运行期间积分处于预留状态。 |
charged | 任务成功、生成结果被内容审核拦截（failed_reason: nsfw_output_blocked），或开始生成后才被取消，预留结算完成。 |
refunded | 任务失败，或在排队时被取消，积分已退回。 |
sandbox | 测试密钥任务，全程不涉及积分。 |
排队期间响应会包含 queue_position。