Use Reference Image 1 only for the copper humanoid robot's oval ivory faceplate, slim adult proportions, articulated copper plates, graphite joints, amber chest line, five-fingered hands, and flat feet. Use Reference Video 1 only for the three-beat choreography, weight shifts, timing, and waist-height semicircular camera path; do not copy the masked performer, indigo suit, ribbon, or black-box theater. Use Reference Audio 1 only for the three action beats and room-to-step timing; replace cloth sound with restrained servo movement. Create one continuous four-second shot on a vast white salt flat at sunrise. The robot performs the same low arc, single pivot, and raised spiral gesture using empty hands, then settles facing the camera. Preserve the referenced robot identity and construction throughout. Synchronized audio: three ceramic-metal foot contacts, quiet servos, and open-air wind. No cuts, no humans, no ribbon, no theater, no dialogue, no music, no readable text, no logos, no brands, no products, no advertising, no watermark.
Seedance 2.0 Reference-to-Video API
seedance-2.0/reference-to-videoSeedance 2.0 参考素材生成视频接口可组合提示词、图片、视频和可选音频。图片负责外观,视频负责动作与镜头节奏,音频负责声音或节拍;必须至少提供图片或视频,三类素材合计最多 12 个。
输入
拖拽文件、粘贴剪贴板素材,或输入 URL。
拖拽文件、粘贴剪贴板素材,或输入 URL。
拖拽文件、粘贴剪贴板素材,或输入 URL。
高级参数
生成音频
请求模型随视频生成音轨。
返回最后一帧
保留视频主结果,并把最后一帧作为额外文件返回。
联网辅助
发送可选的联网辅助生成字段。
输出
等待运行生成文件会显示在这里
设置输入、选择时长,然后运行异步视频任务。
继续使用
示例
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/reference-to-video",
"input": {
"prompt": "Use Reference Image 1 only for the copper humanoid robot's oval ivory faceplate, slim adult proportions, articulated copper plates, graphite joints, amber chest line, five-fingered hands, and flat feet. Use Reference Video 1 only for the three-beat choreography, weight shifts, timing, and waist-height semicircular camera path; do not copy the masked performer, indigo suit, ribbon, or black-box theater. Use Reference Audio 1 only for the three action beats and room-to-step timing; replace cloth sound with restrained servo movement. Create one continuous four-second shot on a vast white salt flat at sunrise. The robot performs the same low arc, single pivot, and raised spiral gesture using empty hands, then settles facing the camera. Preserve the referenced robot identity and construction throughout. Synchronized audio: three ceramic-metal foot contacts, quiet servos, and open-air wind. No cuts, no humans, no ribbon, no theater, no dialogue, no music, no readable text, no logos, no brands, no products, no advertising, no watermark.",
"duration": 4,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0/reference-to-video/v1/input-reference-image.png"
],
"reference_video_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0/reference-to-video/v1/input-reference-video.mp4"
],
"reference_audio_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0/reference-to-video/v1/input-reference-audio.mp3"
],
"generate_audio": true,
"seed": 26082705
}
}'等待结果
仅轮询 not_started 或 running,或使用 callback_url 接收平铺终态对象。
跟踪状态
GET https://api.vidgo.ai/api/generate/status/7IS92RCGLFN0IG3M初始轮询间隔约 2 秒,长任务逐步退避并设置超时。finished 与 failed 都是终态。网络失败、请求超时和任务失败应分别处理;callback_url 使用同一请求契约。
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "7IS92RCGLFN0IG3M",
"status": "running",
"created_time": "2026-08-27T14:29:21"
}
}{
"code": 200,
"data": {
"task_id": "7IS92RCGLFN0IG3M",
"status": "finished",
"progress": 100,
"created_time": "2026-08-27T14:29:21",
"error_message": null,
"files": [
{
"file_type": "video",
"file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0/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/reference-to-video",
"input": {
"prompt": "Use Reference Image 1 only for the copper humanoid robot's oval ivory faceplate, slim adult proportions, articulated copper plates, graphite joints, amber chest line, five-fingered hands, and flat feet. Use Reference Video 1 only for the three-beat choreography, weight shifts, timing, and waist-height semicircular camera path; do not copy the masked performer, indigo suit, ribbon, or black-box theater. Use Reference Audio 1 only for the three action beats and room-to-step timing; replace cloth sound with restrained servo movement. Create one continuous four-second shot on a vast white salt flat at sunrise. The robot performs the same low arc, single pivot, and raised spiral gesture using empty hands, then settles facing the camera. Preserve the referenced robot identity and construction throughout. Synchronized audio: three ceramic-metal foot contacts, quiet servos, and open-air wind. No cuts, no humans, no ribbon, no theater, no dialogue, no music, no readable text, no logos, no brands, no products, no advertising, no watermark.",
"duration": 4,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0/reference-to-video/v1/input-reference-image.png"
],
"reference_video_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0/reference-to-video/v1/input-reference-video.mp4"
],
"reference_audio_urls": [
"https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0/reference-to-video/v1/input-reference-audio.mp3"
],
"generate_audio": true,
"seed": 26082705
}
}
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/7IS92RCGLFN0IG3M" \
--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/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、1080p、4k;体验区默认 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 / 1080p / 4k | Standard 提供完整四档。 |
| 时长 | 4–15 秒整数 | 包含边界值。 |
| 画面比例 | 7 种 | Auto 加六种固定比例。 |
| 计费依据 | 输出 + 参考视频秒数 | 有视频时全部秒数使用含视频费率。 |
相关模型
关于 Seedance 2.0 参考素材生成视频 API 的常见问题
Seedance 2.0 参考素材生成视频 API 是什么?
Seedance 2.0 是 ByteDance Seedance 模型。当前参考素材生成视频端点接收提示词以及图片、视频和可选音频参考,并按照文档中的 REST 请求结构返回异步视频生成任务。
如何调用 Seedance 2.0 参考素材生成视频 API?
通过 Authorization: Bearer VIDGO_API_KEY 调用 POST /api/generate/submit。成功响应包含 task_id,可用于统一状态查询。
Seedance 2.0 参考素材生成视频 API 如何计费?
无参考视频时按输出秒数乘以无视频费率;含参考视频时,输出秒数加上每段参考视频向下取整的秒数,全部乘以含视频费率。480p: 20 credits ($0.100)/s; 720p: 40 credits ($0.200)/s; 1080p: 90 credits ($0.450)/s; 4k: 200 credits ($1.000)/s。
Seedance 2.0 参考素材生成视频 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 并采用较低当前费率。















