#查询状态与下载视频(豆包 / Seedance 格式)
查询与获取视频生成任务状态使用同一端点,响应为统一任务 JSON(状态流转与字段说明见该页)。SUCCESS 后从 data.result_url 下载视频。
#端点
GET /v1/video/generations/{task_id}
#请求示例
建议每 10 秒轮询一次。注意 result_url 为火山 TOS 签名直链,约 24 小时失效,请及时下载转存。
cURL
Python
Node.js
curl https://api-model.shuntianchuang.cn/v1/video/generations/task_xxxxxxxx \
-H "Authorization: Bearer sk-你的令牌"import time
import requests
BASE = "https://api-model.shuntianchuang.cn"
HEADERS = {"Authorization": "Bearer sk-你的令牌"}
task_id = "task_xxxxxxxx" # 创建接口返回的 task_id
while True:
resp = requests.get(
f"{BASE}/v1/video/generations/{task_id}", headers=HEADERS
).json()
data = resp["data"]
print(data["status"], data.get("progress", ""))
if data["status"] in ("SUCCESS", "FAILURE"):
break
time.sleep(10)
if data["status"] == "SUCCESS":
with open("seedance.mp4", "wb") as f:
f.write(requests.get(data["result_url"]).content)
print("已保存 seedance.mp4")
# data.data 为上游原始响应:回显实际生效的参数
upstream = data["data"]
print("实际参数:", {k: upstream.get(k) for k in ("seed", "resolution", "ratio", "duration")})
# 尾帧图(提交时 return_last_frame: true 才有)
last = upstream.get("content", {}).get("last_frame_url")
if last:
with open("last-frame.png", "wb") as f:
f.write(requests.get(last).content)
else:
raise SystemExit(f"任务失败:{data.get('fail_reason')}")import fs from 'node:fs';
const BASE = 'https://api-model.shuntianchuang.cn';
const HEADERS = { Authorization: 'Bearer sk-你的令牌' };
const taskId = 'task_xxxxxxxx'; // 创建接口返回的 task_id
let data;
while (true) {
const resp = await fetch(`${BASE}/v1/video/generations/${taskId}`, {
headers: HEADERS,
});
data = (await resp.json()).data;
console.log(data.status, data.progress ?? '');
if (data.status === 'SUCCESS' || data.status === 'FAILURE') break;
await new Promise((resolve) => setTimeout(resolve, 10_000));
}
if (data.status !== 'SUCCESS') throw new Error(`任务失败:${data.fail_reason}`);
const video = await fetch(data.result_url);
fs.writeFileSync('seedance.mp4', Buffer.from(await video.arrayBuffer()));
// data.data 为上游原始响应:回显实际生效的参数
const upstream = data.data;
console.log('实际参数:', {
seed: upstream.seed,
resolution: upstream.resolution,
ratio: upstream.ratio,
duration: upstream.duration,
});
// 尾帧图(提交时 return_last_frame: true 才有)
const last = upstream.content?.last_frame_url;
if (last) {
const frame = await fetch(last);
fs.writeFileSync('last-frame.png', Buffer.from(await frame.arrayBuffer()));
}#响应体
查询响应为统一任务 JSON。其中 data.data 为上游原始任务响应,回显实际生效的参数值——核对参数是否生效以这里为准:
data.data 字段 | 说明 |
|---|---|
seed / ratio / resolution / duration | 实际生效的生成参数,核对参数是否生效以这里为准 |
framespersecond | 帧率,文生视频固定 24fps |
generate_audio | 是否生成音频,成功产物带音轨 |
usage.completion_tokens | Seedance 2.0 系按 token 计费的实际用量;1.0 系计费规则见模型广场 |
content.video_url | 与 data.result_url 相同的视频直链 |
content.last_frame_url | 尾帧图(提交时 return_last_frame: true 才有) |
#响应示例
{
"code": "success",
"data": {
"task_id": "task_xxxxxxxx",
"status": "SUCCESS",
"progress": "100%",
"result_url": "https://xxxx/video.mp4",
"fail_reason": "",
"data": {
"id": "cgt-xxxx",
"seed": 42,
"ratio": "16:9",
"resolution": "1080p",
"duration": 5,
"framespersecond": 24,
"generate_audio": true,
"output_format": "mp4",
"usage": { "completion_tokens": 245025, "total_tokens": 245025 },
"content": {
"video_url": "https://…/video.mp4",
"last_frame_url": "https://…/last-frame.png"
}
}
}
}#状态回调(可选)
提交时传 metadata.callback_url(公网可达、可收 POST 的地址)后,上游会在每个状态变化时推送一次 POST:body 为上游任务对象 JSON(含 id、model、status、content 等),按 status 字段判断终态(succeeded / failed)。回调与轮询互不冲突,可同时使用。
