跳转到内容

Seedance 2.5 US Reference to Video

集成

模型 id bytedance/seedance-2.5/us/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/seedance-2.5/us/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

每次运行最高 $6.944 按实际用量计费,剩余部分退款 在此页面运行

获取 API 密钥
ByteDance 参考图生视频 原生音频参考输入唇形同步4–30 秒最高 1080p #stylized#transform#lipsync

Seedance 2.5 参考视频生成、编辑和延展,支持最多 30 张图像、10 个视频和 10 个音频

在 Doitong 上制作

Doitong 社区使用 Seedance 2.5 US 制作的公开作品。一键复用提示词。

显示的公开作品:16
Use the input image as the base scene and visual appearance. Use the reference video strictly as ... 视频

Use the input image as the base scene and visual appearance. Use the reference video strictly as a motion reference for the dog’s movement. The dog must move exactly like in the reference video: - same gait (trotting rhythm) - same speed and tempo - same head motion and body dynamics - same ear...

First-person POV of a dog trotting forward along the path at a realistic, moderate speed (approxi... 视频

First-person POV of a dog trotting forward along the path at a realistic, moderate speed (approximately 8 km/h). The camera is positioned low, at the natural height of the dog’s head. The motion follows a true trotting gait: steady, rhythmic, grounded movement with gentle vertical bounce and...

Subject: Young woman with dark hair, pale skin, glowing green eyes. Context: Dark, shadowy room. ... 视频

Subject: Young woman with dark hair, pale skin, glowing green eyes. Context: Dark, shadowy room. Action: Slow subtle breathing, slight blink. Cold direct gaze at camera. Finger pressed to lips. Minimal movement. Style: Cinematic, hyperrealistic, mysterious, intense. Camera motion: Static shot, no...

First-person POV of a dog running forward along the path at a realistic, moderate speed (approxim... 视频

First-person POV of a dog running forward along the path at a realistic, moderate speed (approximately 10 km/h). The camera is positioned low, at the natural height of the dog’s head. The motion follows a true trotting gait: steady, rhythmic, grounded movement with gentle vertical bounce and...

Очень медленный финальный наезд камеры. Пламя свечи на переднем плане горит ярче, создавая блики.... 视频

Очень медленный финальный наезд камеры. Пламя свечи на переднем плане горит ярче, создавая блики. Dialogue in this scene: Астролог: "Но в марте будет одна дата… когда решение изменит всё. Напишите в комментариях “Овен” — и я сделаю отдельный разбор." No background music.

A close-up portrait of a striking cyberpunk woman with sleek dark hair partially wet and falling ... 视频

A close-up portrait of a striking cyberpunk woman with sleek dark hair partially wet and falling around her face. She’s wearing glossy, high-tech neon visor goggles with a vivid color gradient — bright yellow, orange, and pink reflecting glowing city lights. Her expression is confident and...

Ultra-realistic scene featuring miniature construction workers in orange vests and hard hats, act... 视频

Ultra-realistic scene featuring miniature construction workers in orange vests and hard hats, actively working on a giant [pizza]. The tiny workers are using small tools, cranes, and machines to [assemble]. The [pizza] is placed on a metal surface or kitchen countertop. Steam or particles rise...

Slow motion. Low angle camera tilting up at Ilya. Warm light from the kitchen intensifies behind ... 视频

Slow motion. Low angle camera tilting up at Ilya. Warm light from the kitchen intensifies behind him, making him look heroic. On-screen dialogue (characters speak with lip-sync): Илья: "Не трогай её!"; Бабушка Нина: "Илья, отойди! Он же…" No background music.

构建请求

控件根据模型架构生成。更改控件时,代码和价格会同步更新。

指导视频生成的文本提示词。

video_urls
拖放文件,或

提供最多 10 个 MP4 或 MOV 参考视频以指导生成,并在提示词中使用 @Video1、@Video2 及后续编号标签标识。每个文件不超过 200 MB,时长为 1.8–30.2 秒,所有片段总时长最多 30.2 秒。视频必须为 24–60 FPS,宽高比为 0.4–2.5,且每边为 300–6,000 像素。

duration auto

视频时长选择:`auto` 根据提示词交由模型决定,明确指定的时长必须为 4–30 秒。

resolution 默认 720p

输出分辨率:480p 优先速度,720p 提供均衡效果,1080p 提供高质量。

aspect_ratio 默认 auto

输出宽高比:16:9 为横向,9:16 为纵向,1:1 为正方形,21:9 为电影级超宽屏。选择 `auto` 由模型选择宽高比。

高级 images · audios · task · bitrate_mode · codec · end_user_id · seed
image_urls
拖放文件,或

用于视频引导的图像参考,最多 30 个图像,且所有模态合计最多 50 个文件。每个图像最多 30 MB,格式必须为 JPG、PNG、WebP、BMP、TIFF、GIF、HEIC 或 HEIF。在提示词中使用 @Image1、@Image2 及后续编号标签标识这些参考图像。

audio_urls
拖放文件,或

用于视频引导的音频参考:最多 10 个文件,总时长上限为 30.2 秒。每个文件必须为 MP3 或 WAV,时长为 1.8–30.2 秒,大小不超过 15 MB。在提示词中使用 @Audio1、@Audio2 及后续编号标签标识文件。

task 默认 reference

视频任务选择,包含三种行为:`reference` 使用提供的媒体指导生成,editing 修改参考视频,extension 延续参考视频。editing 和 extension 会自动将 `aspect_ratio` 设置为 `auto`;editing 还会将 `duration` 设置为 `auto`。

bitrate_mode 默认 standard

选择输出编码比特率:'standard' 保留默认设置,'high' 要求模型提高编码质量,但会生成更大的文件。

codec 默认 auto

视频编解码器选择:`auto` 保持默认编解码器行为,`H264` 选择 H.264,`H265` 选择 H.265。

分配给最终用户的唯一标识符。

用于使生成结果可复现的随机种子,但不保证完全重复:重复使用该种子仍可能得到略有不同的结果。

POST /run/bytedance/seedance-2.5/us/reference-to-video?wait=20 报价 → $6.944
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/seedance-2.5/us/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 Seedance 2.5 US Reference to Video

`task` 设置可在参考引导生成、编辑参考视频和延展参考视频之间切换。接受最多 30 张图像、10 个视频和 10 个音频文件作为参考,并以 @Image1 等形式引用。输出为 480p、720p 或 1080p,时长为 auto 或 4 到 30 秒,宽高比为 21:9 至 9:16。支持 `seed` 和 `bitrate_mode`。

参数

发送规范名称或原生名称之一,不要同时发送两者。 规范名称

名称类型 默认值允许值 描述
prompt可选
类型string | null
指导视频生成的文本提示词。
task可选
类型enum
默认值reference
referenceeditingextension
视频任务选择,包含三种行为:`reference` 使用提供的媒体指导生成,editing 修改参考视频,extension 延续参考视频。editing 和 extension 会自动将 `aspect_ratio` 设置为 `auto`;editing 还会将 `duration` 设置为 `auto`。
image_urls可选 images
类型url[] · image
用于视频引导的图像参考,最多 30 个图像,且所有模态合计最多 50 个文件。每个图像最多 30 MB,格式必须为 JPG、PNG、WebP、BMP、TIFF、GIF、HEIC 或 HEIF。在提示词中使用 @Image1、@Image2 及后续编号标签标识这些参考图像。
video_urls可选 videos
类型url[] · video
提供最多 10 个 MP4 或 MOV 参考视频以指导生成,并在提示词中使用 @Video1、@Video2 及后续编号标签标识。每个文件不超过 200 MB,时长为 1.8–30.2 秒,所有片段总时长最多 30.2 秒。视频必须为 24–60 FPS,宽高比为 0.4–2.5,且每边为 300–6,000 像素。
audio_urls可选 audios
类型url[] · audio
用于视频引导的音频参考:最多 10 个文件,总时长上限为 30.2 秒。每个文件必须为 MP3 或 WAV,时长为 1.8–30.2 秒,大小不超过 15 MB。在提示词中使用 @Audio1、@Audio2 及后续编号标签标识文件。
resolution可选
类型enum
默认值720p
480p720p1080p
输出分辨率:480p 优先速度,720p 提供均衡效果,1080p 提供高质量。
duration可选
类型enum
默认值auto
auto456789101112131415161718
另外 12 个192021222324252627282930
视频时长选择:`auto` 根据提示词交由模型决定,明确指定的时长必须为 4–30 秒。
aspect_ratio可选
类型enum
默认值auto
auto21:916:94:31:13:49:16
输出宽高比:16:9 为横向,9:16 为纵向,1:1 为正方形,21:9 为电影级超宽屏。选择 `auto` 由模型选择宽高比。
generate_audio可选
类型boolean
默认值true
启用此选项可为视频生成同步音频。生成的音频包括与嘴部动作匹配的语音、环境氛围声和音效。
bitrate_mode可选
类型enum
默认值standard
standardhigh
选择输出编码比特率:'standard' 保留默认设置,'high' 要求模型提高编码质量,但会生成更大的文件。
codec可选
类型enum
默认值auto
autoH264H265
视频编解码器选择:`auto` 保持默认编解码器行为,`H264` 选择 H.264,`H265` 选择 H.265。
seed可选
类型integer | null
用于使生成结果可复现的随机种子,但不保证完全重复:重复使用该种子仍可能得到略有不同的结果。
end_user_id可选
类型string | null
分配给最终用户的唯一标识符。
必填 规范名称,也可接受

文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bytedance/seedance-2.5/us/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 6944,
    "usd": "6.944",
    "charged": 6944,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "draft_id": "string"
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
你的文件,由你选择每个 outputs[].url 都是存储中的副本:可永久保存(按 GB-月付费),也可免费保存 7 天,由账户设置或 ?storage= 决定。
每个模型的结构相同图像、视频和音频均包含 type、url、content_type、width、height 和 duration。output 是模型自身的结果对象。
输出字段
video
object {url, content_type, file_name, file_size}生成得到的视频文件。
seed
integer生成期间应用的种子值。
draft_id
string | null同一账户在七天内完成任务所需的草稿标识符;如果禁用草稿模式,响应中会返回 null。

更多模型:参考图生视频

对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/bytedance/seedance-2.5/us/reference-to-video.md. 所有模型和指南: https://doitong.com/developers/llms.txt