跳转到主要内容
GET
/
v1
/
tasks
/
{task_id}
查询任务状态
curl --request GET \
  --url https://www.qingbo.dev/v1/tasks/{task_id}
{
  "task_id": "<string>",
  "status": "<string>",
  "action": "<string>",
  "model": "<string>",
  "progress": 123,
  "created_at": 123,
  "completed_at": 123,
  "error": {},
  "result": {},
  "urls": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

异步任务的核心查询端点。提交任务后(POST /v1/tasks)返回 task_id,通过此端点轮询状态,直到 status: completed 取最终结果。

​
调用示例

curl https://www.qingbo.dev/v1/tasks/task-wave1775285160b950328499 \
  -H "Authorization: Bearer $WAVE_API_KEY"

​
响应示例(各阶段)

{
  "task_id": "task-wave1775285160b950328499",
  "status": "queued",
  "action": "generate",
  "model": "wan2.7",
  "progress": 0,
  "created_at": 1720000000,
  "urls": {
    "get": "https://www.qingbo.dev/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://www.qingbo.dev/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

​
响应字段

​
task_id
string
任务唯一 ID(提交时返回)
​
status
string
任务状态:
  • queued — 已提交,等待处理
  • processing — 处理中,progress 字段表示进度(0-100)
  • completed — 完成,result 含生成结果
  • failed — 失败,error 含错误信息
  • cancelled — 已取消(只能取消 queued 状态)
​
action
string
操作类型,跟提交时一致(generate / edit / image2video 等)
​
model
string
使用的模型 ID(group_name)
​
progress
integer
进度,0-100 整数。queued / failed / cancelled 状态下为 0,completed 为 100
​
created_at
integer
创建时间(Unix 毫秒时间戳)
​
completed_at
integer
完成时间(Unix 毫秒时间戳),仅 completed / failed / cancelled 态有此字段
​
error
object
错误信息,仅 failed 态有此字段:
  • message — 错误描述
  • code — 错误码(常用 task_failed)
​
result
object
生成结果,仅 completed 态有此字段。根据任务媒体类型,key 为 images / videos / audios(数组),每项含:
  • url — string[] 数组(单元素也用数组形式)
  • expires_at — Unix 时间戳,链接有效期(默认 3 天)
​
urls
object
快捷操作链接,方便客户端不必拼接 URL:
  • get — 当前查询地址
  • cancel — 取消任务地址

​
轮询建议

  • 轮询间隔:2-5 秒一次
  • 最大等待时间:建议 5 分钟超时(视频可能更久)
  • 检查 progress 显示给用户实时进度
  • 优先用 Webhook:提交时设 callback_url,完成时主动推送,免轮询
详见 任务系统 完整流程说明。
生成结果链接 24 小时-3 天有效期(expires_at 字段),请及时下载保存到自己的存储。过期后链接失效,需要重新提交任务。

​
错误码

状态码错误说明
404task_not_foundtask_id 不存在或不属于当前 user
401认证失败API Key 无效

​
相关文档