Seedance 2.5

CAPABILITIES

能力与限制

支持模式

文生视频首帧首尾帧参考素材视频编辑视频延长

使用前需了解

支持按模式配置图片、视频或音频输入；编辑与延长使用专用字段。费用按最终计量结算，不能把处理耗时当作视频时长。

规格与默认值
参数	支持值 / 默认
分辨率	480p / 720p / 1080p
输出时长	4–30 秒 / 自动（按模式）
画幅	21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive
提示词限制	20000 Unicode 码点
定义默认值（以模式规则为准）	duration: 5 · resolution: 720p · aspect_ratio: adaptive
参考素材上限	30 图片 / 10 视频 / 10 音频

素材上限不表示所有模式可以组合使用。具体大小、格式与互斥规则见完整字段说明。

查看完整请求字段与限制（中文）↗

字段	字段含义	类型	是否必选	默认值	可选值 / 范围	备注说明（模式与素材限制）	模型专用特殊字段
`model`	调用型号的接口标识	string	是	无	seedance-2.5	固定调用名称，按示例精确填写	否
`prompt`	描述内容、动作、镜头或编辑意图的提示词	string	是	无	1～20000 Unicode码点	所有模式必填；edit描述编辑／删除／替换，extend描述向前／向后延长；@图片1等编号按各数组顺序	否
`duration`	输出视频时长，单位秒	integer	否	5；edit为-1	4～30秒或-1	-1为自动时长；edit必须-1，省略时也为-1	否
`resolution`	输出视频分辨率	string	否	720p	480p / 720p / 1080p	按本行可选值选择输出分辨率	否
`aspect_ratio`	输出画幅宽高比	string	否	adaptive	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive	平台统一字段；首尾帧/edit/extend只接受adaptive	否
`generate_audio`	是否生成输出视频的声音	boolean	否	true	true / false	输出是否含声音	否
`output_format`	输出视频的文件格式	string	否	mp4	mp4 / mov	MP4的MIME为video/mp4，MOV为video/quicktime；按实际结果保存	是 · Seedance
`return_last_frame`	是否同时返回输出视频的尾帧图片	boolean	否	false	true / false	开启后从result.artifacts读取可用的last-frame图片；与尾帧输入是不同功能	是 · Seedance
`omni_reference_task_type`	参考素材的处理方式	string	否	有参考素材reference，否则auto	auto / reference / edit / extend	文生／首尾帧用auto；素材参考用reference；edit或extend必须有video_urls，画幅为adaptive	是 · Seedance
`image_with_roles`	明确指定图片用途的数组	object[]	否	无	{url,role}	首尾帧与参考模式互斥；尾帧须搭配首帧；不重复角色	否
`image_with_roles[].url`	数组内单张图片的地址	string	数组内是	无	HTTPS URL	所有图片字段统一要求：PNG / JPEG / WebP / BMP / GIF；单文件≤30MiB；宽、高均300～6000像素；宽高比0.4～2.5	否
`image_with_roles[].role`	数组内图片的用途	string	数组内是	无	first_frame / last_frame / reference_image	首尾各≤1张；reference_image与image_urls合计≤30张；两类模式互斥	否
`first_frame_image`	约束视频开始画面的图片地址	string	首帧／首尾帧模式需提供；可用角色替代	无	HTTPS URL	首帧≤1张；与参考素材互斥，不与角色重复；图片规格见image_with_roles[].url	否
`last_frame_image`	约束视频结束画面的图片地址	string	首尾帧模式需提供；可用角色替代	无	HTTPS URL	尾帧≤1张且须搭配首帧；与参考素材互斥；图片规格见image_with_roles[].url	否
`image_urls`	图片地址数组	string[]	否	无	≤30张	一律参考图，和reference_image合计≤30张；首尾帧用对应字段或角色	否
`video_urls`	参考视频地址数组	string[]	否	无	≤10段	MP4 / MOV；单文件≤200MiB；单段2～30秒；视频合计≤30秒；edit每段至少4秒；宽、高均300～6000像素；宽高比0.4～2.5；总像素409600～8295044；24～60fps	否
`audio_urls`	参考音频地址数组	string[]	否	无	≤10段	PCM WAV / MP3（含Xing/Info）；单文件≤15MiB；单段2～30秒；音频合计≤30秒；可单独作为参考素材	否
`seed`	随机种子	integer	否	未指定	JS安全整数	可复现性不保证完全一致	是 · Seedance / Wan / Vidu
`watermark`	是否请求输出水印	boolean	否	false	true / false	输出水印	是 · H3 / H3 Max / Seedance / Wan
`nsfw_check`	额外审核选项，本版仅接受false	boolean	否	false	仅false	true不支持	是 · 除Vidu与Regeneration外的型号

目录展示已实现的适配能力，不代表所有型号或规格均向当前账户开放。实际启用状态、权限与默认值以本人 /v1/models 为准。

查看完整请求字段与限制（中文）↗

CREATIVE WORKFLOWS

适用场景

从文字或图片参考生成镜头。
通过编辑模式修改现有视频。
通过专用延长字段衔接已有视频。

概念视觉，非生成样片；本页尚无经过验证的模型实拍样例。

PRICING / USD

按所选规格计费。

售价为 USD。参考价格带采集日期；缺价不代表免费。历史任务仍按创建时的价格快照结算。

正在读取当前价格…

模型价格 ↗

API INTEGRATION

接入示例

在自己的服务端使用 HTTP 接入，选择模型与参数；先由服务方配置账户、Key 和逐模型权限。

202 表示已受理。保存任务编号，按 next_poll_after_seconds 查询；生成状态、产物可用性与费用状态分别判断。

HTTP / cURL

curl --request POST 'https://bytesota-api.businessmodelcraft.com/v1/videos/generations' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-seedance-text-480p-001' \
  --data-raw '{
    "model": "seedance-2.5",
    "prompt": "小猫沿花园小径向前走，镜头缓缓跟随。",
    "duration": 5,
    "resolution": "480p",
    "aspect_ratio": "adaptive",
    "generate_audio": true,
    "output_format": "mp4"
  }'

查询结果

HTTP / cURL

curl 'https://bytesota-api.businessmodelcraft.com/v1/tasks/vid_ABCDEFGHIJKLMNOP' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY'

示例仅供复制，不会在网页中执行；凭证为占位符。

规格与示例来源：模型定义及公开 API 接入指南。

阅读完整 API 文档（中文）↗