视频

查询视频生成状态

轮询视频任务状态。终态只有 completed / failed;进行中通常是 pending / processing,也可能透传上游的进行中字样(如 in_progress)——请以「等到 completed 或 failed」写轮询逻辑,不要穷举中间态。上游端的取消/逾期(cancelled / expired)一律以 failed 呈现并已退还预留额度。completed 时 unsigned_urls 列出可下载的内容路径、usage.cost 为最终计费金额(按实际交付秒数);failed 时 error 说明原因。服务器端对上游的查询有 8 秒节流,客户端建议以 ≥5 秒间隔轮询。

GET/api/v1/videos/:id

验证

Authorization必填

string · header

在 Authorization 标头以 Bearer token 传入 API 密钥。

路径参数

id必填

string

提交时返回的任务 id(vjob_ 开头)。只能查询属于同一账户的任务。

Example: "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"

深度指南 →

GET /api/v1/videos/:id

1
2
curl https://bazaarlink.ai/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

响应示例

成功。下例为 completed 任务;pending / processing 时没有 unsigned_urls 与 usage,failed 时多一个 error 字段。unsigned_urls 是相对路径,带同一把密钥去 GET 即可下载。

1
2
3
4
5
6
7
8
9
10
11
12
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "completed",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "unsigned_urls": [
    "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk/content?index=0"
  ],
  "usage": {
    "cost": 0.5,
    "is_byok": false
  }
}