Use Reference Image 1 only for the compact rover's rounded white crackle-ceramic body, four cobalt-blue wheels, brass sensor mast, dark glass sensor band, folded sampling arm, proportions, and materials. Use Reference Video 1 only for the curved route, quick right-left correction, stop timing, and low constant-distance camera track; do not copy the brass beetle, wooden blocks, washer, or worktable. Use Reference Audio 1 only for movement cadence and stop cue; replace leg taps with wheel and greenhouse sounds. Create one continuous four-second shot inside a misty glass greenhouse at dawn. The rover follows a curved wet-stone path between two empty planting beds, makes one right-left correction, then stops beneath a dripping irrigation pipe. Preserve the referenced rover identity, four wheels, and body geometry throughout. Synchronized audio: four wheels on wet stone, quiet electric steering, one water drop, and ventilation ambience. No cuts, no insects, no worktable, no blocks, no extra vehicles, no people, no readable text, no logos, no brands, no products, no advertising, no watermark.
Seedance 2.0 Fast 参考素材生成视频
seedance-2.0-fast/reference-to-videoSeedance 2.0 Fast 参考素材生成视频接口可组合提示词、图片、视频和可选音频。图片负责外观,视频负责动作与镜头节奏,音频负责声音或节拍;必须至少提供图片或视频,三类素材合计最多 12 个。
输入
高级参数
生成音频
请求模型随视频生成音轨。
返回最后一帧
保留视频主结果,并把最后一帧作为额外文件返回。
联网辅助
发送可选的联网辅助生成字段。
输出
等待运行生成文件会显示在这里
设置输入、选择时长,然后运行异步视频任务。
继续使用
示例
REST API
快速开始
完成认证,提交最小合法的参考素材生成视频请求,再取得异步视频结果。
连接 Vidgo API
创建 API 密钥,仅保存在服务端,并通过 Bearer Header 发送。
- 端点
- POST
https://api.vidgo.ai/api/generate/submit - 认证
- Authorization: Bearer VIDGO_API_KEY
提交一个生成任务
发送精确模型 ID 和当前模式必填字段,成功后立即取得 task_id。
curl --request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-2.0-fast/reference-to-video",
"callback_url": "https://httpbin.org/post",
"input": {
"prompt": "Use Reference Image 1 only for the compact rover's rounded white crackle-ceramic body, four cobalt-blue wheels, brass sensor mast, dark glass sensor band, folded sampling arm, proportions, and materials. Use Reference Video 1 only for the curved route, quick right-left correction, stop timing, and low constant-distance camera track; do not copy the brass beetle, wooden blocks, washer, or worktable. Use Reference Audio 1 only for movement cadence and stop cue; replace leg taps with wheel and greenhouse sounds. Create one continuous four-second shot inside a misty glass greenhouse at dawn. The rover follows a curved wet-stone path between two empty planting beds, makes one right-left correction, then stops beneath a dripping irrigation pipe. Preserve the referenced rover identity, four wheels, and body geometry throughout. Synchronized audio: four wheels on wet stone, quiet electric steering, one water drop, and ventilation ambience. No cuts, no insects, no worktable, no blocks, no extra vehicles, no people, no readable text, no logos, no brands, no products, no advertising, no watermark.",
"duration": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"reference_image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/reference-to-video/v1/input-reference-image.png"
],
"reference_video_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/reference-to-video/v1/input-reference-video.mp4"
],
"reference_audio_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/reference-to-video/v1/input-reference-audio.mp3"
],
"generate_audio": true,
"seed": 26082706
}
}'等待结果
仅轮询 not_started 或 running,或使用 callback_url 接收平铺终态对象。
跟踪状态
GET https://api.vidgo.ai/api/generate/status/I4FDXYJ7C1LQT4H2初始轮询间隔约 2 秒,长任务逐步退避并设置超时。finished 与 failed 都是终态。网络失败、请求超时和任务失败应分别处理;callback_url 使用同一请求契约。
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "I4FDXYJ7C1LQT4H2",
"status": "running",
"created_time": "2026-08-27T14:38:03"
}
}{
"code": 200,
"data": {
"task_id": "I4FDXYJ7C1LQT4H2",
"status": "finished",
"progress": 100,
"created_time": "2026-08-27T14:38:03",
"error_message": null,
"files": [
{
"file_type": "video",
"file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/reference-to-video/v1/output.mp4"
}
]
}
}完整可运行示例
示例包含 HTTP 与业务码检查、task_id 校验、退避轮询、超时、终态与结果提取。
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "seedance-2.0-fast/reference-to-video",
"callback_url": "https://httpbin.org/post",
"input": {
"prompt": "Use Reference Image 1 only for the compact rover's rounded white crackle-ceramic body, four cobalt-blue wheels, brass sensor mast, dark glass sensor band, folded sampling arm, proportions, and materials. Use Reference Video 1 only for the curved route, quick right-left correction, stop timing, and low constant-distance camera track; do not copy the brass beetle, wooden blocks, washer, or worktable. Use Reference Audio 1 only for movement cadence and stop cue; replace leg taps with wheel and greenhouse sounds. Create one continuous four-second shot inside a misty glass greenhouse at dawn. The rover follows a curved wet-stone path between two empty planting beds, makes one right-left correction, then stops beneath a dripping irrigation pipe. Preserve the referenced rover identity, four wheels, and body geometry throughout. Synchronized audio: four wheels on wet stone, quiet electric steering, one water drop, and ventilation ambience. No cuts, no insects, no worktable, no blocks, no extra vehicles, no people, no readable text, no logos, no brands, no products, no advertising, no watermark.",
"duration": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"reference_image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/reference-to-video/v1/input-reference-image.png"
],
"reference_video_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/reference-to-video/v1/input-reference-video.mp4"
],
"reference_audio_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/reference-to-video/v1/input-reference-audio.mp3"
],
"generate_audio": true,
"seed": 26082706
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
while true; do
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/I4FDXYJ7C1LQT4H2" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep 2
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
done请求参数
model 与可选 callback_url 位于顶层;生成字段位于 input,额外属性会被拒绝或忽略。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | — | 必须为 seedance-2.0-fast/reference-to-video. |
| callback_url | string (URL) | 否 | — | 接收终态任务对象的公开 HTTP(S) 地址。 |
| input | object | 是 | — | 只包含当前模式公开字段。 |
| input.prompt | string | 必填 | — | trim 后 1–20,000 个字符;体验区提供示例提示词。 |
| input.duration | integer | 必填 | — | 4–15 的整数,包含边界;体验区默认 5 秒。 |
| input.resolution | string | 必填 | 720p | 支持 480p、720p;体验区默认 720p。 |
| input.aspect_ratio | string | 可选 | 16:9 | 支持 auto、21:9、16:9、4:3、1:1、3:4、9:16;体验区默认 16:9。 |
| input.reference_image_urls | string[] | 条件必填 | — | 最多 9 个公开图片 URL;图片或视频至少一类存在。 |
| input.reference_video_urls | string[] | 条件必填 | — | 最多 3 个公开视频 URL;每段时长向下取整后加入计费秒。 |
| input.reference_audio_urls | string[] | 可选 | — | 最多 3 个公开音频 URL;不能单独提交。三类素材合计最多 12 个。 |
| input.generate_audio | boolean | 可选 | true | boolean;体验区默认并显式发送 true。 |
| input.return_last_frame | boolean | 可选 | false | boolean;体验区默认并显式发送 false。 |
| input.web_search | boolean | 可选 | false | boolean;体验区默认并显式发送 false。 |
| input.seed | integer | 可选 | — | 整数;公开契约未声明范围,留空时省略。 |
| 不接受的媒体字段 | — | — | — | image_urls, start_image_url, end_image_url, video_url, video_urls; _reference_video_billing_seconds is internal |
响应字段
提交响应提供任务身份,状态响应提供进度、全部结果文件或失败信息。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 业务返回码;成功兼容 0 与 200。 |
| message | string | 可选的响应或错误说明。 |
| data.task_id | string | 提交后用于查询状态的任务 ID。 |
| data.status | string | not_started, running, finished, or failed. |
| data.created_time | string | 任务创建时间。 |
| data.progress | integer | 已报告的完成百分比。 |
| data.files[] | array | 按返回顺序排列的全部结果文件。 |
| data.files[].file_url | string | 结果文件直链。 |
| data.files[].file_type | string | video、image 或其他公开类型。 |
| data.files[].watermark_url | string | null | 后端提供时的水印文件 URL。 |
| data.error_message | string | null | 失败终态的错误说明。 |
任务生命周期
not_started 与 running 为非终态;finished 与 failed 为终态。
not_started请求已接收,等待执行。
running生成进行中,按退避策略继续轮询。
finished成功终态,读取全部 files。
failed失败终态,读取 error_message 并停止。
轮询与错误
- 认证401 表示 Bearer Key 缺失或无效,修正后再请求。
- 校验400 表示请求违反当前端点契约,按字段错误修正。
- 余额不足余额不足与普通 400 分开提示所需积分和美元金额。
- 轮询与超时约 2 秒开始并逐步退避;网络失败和客户端超时不是任务 failed。
- 终态与 callbackfinished 或 failed 立即停止;callback_url 可接收同一任务的平铺终态对象。
模型规格
| 规格 | 取值 | 说明 |
|---|---|---|
| 输入模式 | 提示词与参考素材 | 至少一张图片或一个视频。 |
| 输出 | 异步视频任务 | 可能返回多个文件,按顺序全部展示。 |
| 分辨率 | 480p / 720p | Fast 不接受 1080p 或 4K。 |
| 时长 | 4–15 秒整数 | 包含边界值。 |
| 画面比例 | 7 种 | Auto 加六种固定比例。 |
| 计费依据 | 输出 + 参考视频秒数 | 有视频时全部秒数使用含视频费率。 |
Seedance 2.0 Fast 参考素材生成视频
Seedance 2.0 Fast 参考素材生成视频接口可组合提示词、图片、视频和可选音频。图片负责外观,视频负责动作与镜头节奏,音频负责声音或节拍;必须至少提供图片或视频,三类素材合计最多 12 个。
为什么选择这个接口?
素材角色可拆分。图片、视频和音频分别控制外观、动作镜头与声音节拍。
当前费率更低。480p 与 720p 适合成本敏感的迭代和批量试验。
时长控制连续。可选择 4–15 秒范围内的任意整数,不受少数预设时长限制。
音频与末帧可控。可显式请求生成音轨、返回末帧,并保留联网辅助与 seed 控制。
参数
| 参数 | 要求 | 说明 |
|---|---|---|
| prompt | 必填 | trim 后 1–20,000 个字符;体验区提供示例提示词。 |
| duration | 必填 | 4–15 的整数,包含边界;体验区默认 5 秒。 |
| resolution | 必填 | 支持 480p、720p;体验区默认 720p。 默认值 720p480p |
| aspect_ratio | 可选 | 支持 auto、21:9、16:9、4:3、1:1、3:4、9:16;体验区默认 16:9。 默认值 16:99:161:121:94:33:4auto |
| reference_image_urls | 条件必填 | 最多 9 个公开图片 URL;图片或视频至少一类存在。 |
| reference_video_urls | 条件必填 | 最多 3 个公开视频 URL;每段时长向下取整后加入计费秒。 |
| reference_audio_urls | 可选 | 最多 3 个公开音频 URL;不能单独提交。三类素材合计最多 12 个。 |
| generate_audio | 可选 | boolean;体验区默认并显式发送 true。 默认值 true |
| return_last_frame | 可选 | boolean;体验区默认并显式发送 false。 默认值 false |
| web_search | 可选 | boolean;体验区默认并显式发送 false。 默认值 false |
| seed | 可选 | 整数;公开契约未声明范围,留空时省略。 |
使用方法
分配参考素材用图片定义外观、视频定义动作镜头、音频定义声音节拍。
描述动作用具体动词说明主体运动,并与镜头移动分开书写。
设置输出选择 480p、720p、4–15 秒时长和适用画面比例。
检查高级参数确认音频、末帧、联网辅助与 seed 是否符合本次任务。
提交并跟踪运行请求,再轮询任务 ID 或处理终态 callback。
价格
1 积分 = $0.005。无参考视频时按输出时长计费;含参考视频时,输出时长加上每段参考视频向下取整的秒数,全部使用含视频费率。
| 计费项 | 费率 | 说明 |
|---|---|---|
| 480p 计费 | 14 / 9 积分每计费秒 | 无参考视频为 $0.070/秒;含参考视频为 $0.045/计费秒,并计入参考视频时长。 |
| 720p 计费 | 28 / 20 积分每计费秒 | 无参考视频为 $0.140/秒;含参考视频为 $0.100/计费秒,并计入参考视频时长。 |
适用场景
角色参考镜头用角色图片描述外观,并用参考视频描述新镜头中的动作。
动作参考以参考视频的动作与机位节奏指导新片段。
品牌视觉以图片参考维持产品、人物或视觉风格。
节奏驱动片段使用音频参考规划声音或节拍意图。
实用技巧
- 按主体与场景、动作、镜头、光线氛围、声音意图的顺序写提示词。
- 在提示词中明确每份素材的角色,避免参考目标互相冲突。
- 用具体运动动词,并把主体运动与镜头运动分开。
- 先确定画面比例和构图,再描述主体在画面中的位置。
- 需要节奏变化时,说明开场、发展与结束三个动作节点。
注意事项
- 图片最多 9 个、视频最多 3 个、音频最多 3 个,合计最多 12 个;音频不能单独提交。
- resolution 在公开 OpenAPI 中为必填,示例与体验区始终显式发送。
- _reference_video_billing_seconds 是后端内部字段,前端和 API 请求不得发送。
- Fast 只接受 480p 与 720p,不支持 1080p 或 4K。
- 任务为异步流程,只在 not_started 与 running 时继续轮询。
关于 Seedance 2.0 Fast 参考素材生成视频 API 的常见问题
Seedance 2.0 Fast 参考素材生成视频 API 是什么?
Seedance 2.0 Fast 是 ByteDance Seedance 模型。当前参考素材生成视频端点接收提示词以及图片、视频和可选音频参考,并按照文档中的 REST 请求结构返回异步视频生成任务。
如何调用 Seedance 2.0 Fast 参考素材生成视频 API?
通过 Authorization: Bearer VIDGO_API_KEY 调用 POST /api/generate/submit。成功响应包含 task_id,可用于统一状态查询。
Seedance 2.0 Fast 参考素材生成视频 API 如何计费?
无参考视频时按输出秒数乘以无视频费率;含参考视频时,输出秒数加上每段参考视频向下取整的秒数,全部乘以含视频费率。480p: 14 credits ($0.070)/s; 720p: 28 credits ($0.140)/s。
Seedance 2.0 Fast 参考素材生成视频 API 接受哪些输入?
接受提示词、最多 9 张图片、3 个视频和 3 个音频参考,合计最多 12 个;至少需要图片或视频,音频不能单独提交。
如何获取生成视频?
轮询 GET /api/generate/status/{task_id},或提交 callback_url。只在 not_started、running 时继续;finished 后从 data.files[].file_url 读取全部结果,failed 时停止并处理错误。
应该选择哪个 Seedance 2.0 端点?
无源素材选择 Text,首帧或首尾帧选择 Image,需要图片、视频或音频共同引导时选择 Reference。Standard 提供到 4K 的更多分辨率,Fast 仅 480p/720p 并采用较低当前费率。


