查询任务状态

GET

tasks

{task_id}

查询任务状态

curl --request GET \
  --url https://api.qingbo.ai/v1/tasks/{task_id}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "task_id": "<string>",
  "status": "<string>",
  "action": "<string>",
  "model": "<string>",
  "progress": "<string>",
  "created_at": 123,
  "completed_at": 123,
  "cost": 123,
  "error": {},
  "result": {},
  "urls": {}
}

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

调用示例

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

响应示例(各阶段)

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

{
  "task_id": "task-wave1775285160b950328499",
  "status": "processing",
  "action": "generate",
  "model": "wan2.7",
  "progress": "45%",
  "created_at": 1720000000,
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

{
  "task_id": "task-wave1775285160b950328499",
  "status": "completed",
  "action": "generate",
  "model": "wan2.7",
  "progress": "100%",
  "created_at": 1720000000,
  "completed_at": 1720000030,
  "cost": 75000,
  "result": {
    "videos": [
      {
        "expires_at": 1720259200,
        "url": ["https://cdn.qingbo.dev/output/xxx.mp4"]
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

{
  "task_id": "task-wave1775285160b950328499",
  "status": "completed",
  "action": "generate",
  "model": "seedream-5.0-lite",
  "progress": "100%",
  "created_at": 1720000000,
  "completed_at": 1720000030,
  "cost": 5500,
  "result": {
    "images": [
      {
        "expires_at": 1720259200,
        "url": ["https://cdn.qingbo.dev/output/xxx.png"]
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

{
  "task_id": "task-wave1775285160b950328499",
  "status": "failed",
  "action": "generate",
  "model": "wan2.7",
  "progress": "100%",
  "created_at": 1720000000,
  "completed_at": 1720000005,
  "cost": 0,
  "error": {
    "message": "[upstream_bad_request] Upstream returned: invalid prompt",
    "code": "upstream_bad_request"
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

响应字段

string

任务唯一 ID(提交时返回)

string

任务状态:

queued — 已提交,等待处理
processing — 处理中,progress 字段表示进度(百分比字符串)
completed — 完成,result 含生成结果
failed — 失败,error 含错误信息
cancelled — 已取消(只能取消 queued 状态)

string

操作类型,跟提交时一致(generate / edit / image2video 等)

string

使用的模型 ID(group_name)

string

进度,百分比字符串(如 "30%"、"100%")。刚入队时可能为空字符串;终态(completed / failed)为 "100%"。注意提交响应里的 progress 是整数 0,查询响应里是字符串,请勿按数字解析。

integer

创建时间(Unix 秒时间戳)

integer

完成时间(Unix 秒时间戳),仅 completed / failed / cancelled 态有此字段

integer

任务实际扣费(quota),仅终态(completed / failed / cancelled)有此字段。成功 = 实际结算额度;失败 / 取消已自动退款时为 0。对账以此字段为准。

object

错误信息,仅 failed 态有此字段:

message — 错误描述
code — 结构化错误码,常见:upstream_unavailable(上游不可用,可重试) / upstream_bad_request(参数被上游拒绝) / upstream_rate_limited(上游限流) / task_failed(其他失败)

object

生成结果,仅 completed 态有此字段。根据任务媒体类型,key 为 images / videos / audios(数组),每项含:

url — string[] 数组(单元素也用数组形式)
expires_at — Unix 秒时间戳,产物的删除时刻。自任务完成时刻起算 7 天,同一个任务查多少次都是同一个值;到期后对象存储会自动删除该文件

object

快捷操作链接,方便客户端不必拼接 URL:

get — 当前查询地址
cancel — 取消任务地址

轮询建议

轮询间隔:2-5 秒一次
最大等待时间:建议 5 分钟超时(视频可能更久)
检查 progress 显示给用户实时进度
优先用 Webhook:提交时设 callback_url,完成时主动推送,免轮询

详见任务系统完整流程说明。

生成结果请及时下载保存到自己的存储。 产物在我方对象存储只保留 7 天(自任务完成时刻起算,即 expires_at),到期由存储的生命周期规则自动删除,不再可取。结果链接不能当长期存储用。

错误码

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

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

查询任务状态

调用示例

响应示例(各阶段)

响应字段

轮询建议

错误码

相关文档

​调用示例

​响应示例(各阶段)

​响应字段

​轮询建议

​错误码

​相关文档

调用示例

响应示例(各阶段)

响应字段

轮询建议

错误码

相关文档