豆包视频列表查询 - 批量获取任务状态 - apizt API 中转接口

本页为 Seedance 1.x 的 /volc/v1 异步协议。当前 Seedance 2.x 目录使用 /api/v3;任务 ID、创建参数和查询路径按协议分开。

型号与创建入口核对日期:2026-10-08。来源:apizt 当前模型目录。目录收录不等于你的令牌已开通权限,提交前核对账户模型与价格。

GEThttps://api.apizt.com/volc/v1/contents/generations/tasks在线调试 →

请求参数

参数说明
page_sizeURL 查询参数;填入对应资源 ID。
filter.statusURL 查询参数;填入对应资源 ID。

GET 请求不发送 body。路径中的任务 ID 和 URL 查询参数须替换为自己的值。

请求示例代码

先设置 tokenba_API_KEY;Python 安装 requests,JavaScript 使用 Node.js 20+。示例未进行付费生成实测。

curl --fail-with-body --request GET "https://api.apizt.com/volc/v1/contents/generations/tasks?page_size=3&filter.status=succeeded" \
  --header "Authorization: Bearer $tokenba_API_KEY"
import os
import requests

headers = {"Authorization": f"Bearer {os.environ['tokenba_API_KEY']}"}
response = requests.get('https://api.apizt.com/volc/v1/contents/generations/tasks?page_size=3&filter.status=succeeded', headers=headers, timeout=60)
response.raise_for_status()
print(response.json())
(async () => {
  const headers = { Authorization: `Bearer ${process.env.tokenba_API_KEY}` };
  const response = await fetch("https://api.apizt.com/volc/v1/contents/generations/tasks?page_size=3&filter.status=succeeded", { method: "GET", headers });
  if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  console.log(await response.json());
})().catch(console.error);

返回响应

响应参数 🟢 200 OK · application/json
total integer
必需
items array [object]
必需
id string
必需
model string
必需
status string
必需
content object
必需
usage object
必需
created_at integer
必需
updated_at integer
必需
{ "total": 0, "items": [ { "id": "string", "model": "string", "status": "string", "content": { "video_url": "string" }, "usage": { "completion_tokens": 0, "total_tokens": 0 }, "created_at": 0, "updated_at": 0 } ] }