Seedance 2.5 首尾帧生视频
适用于 dreamina-seedance-2-5-260628 模型。提交任务后,请通过 GET /v1/videos/{task_id} 查询状态。
授权
在请求头中传入 Authorization: Bearer <token>。
请求体
您需要调用的模型的 ID (Model ID)
dreamina-seedance-2-5-260628 多模态输入数组。必须包含 text、first_frame、last_frame 三种类型各一个。
3生成视频时长,仅支持整数,单位:秒。
- Seedance 2.5 系列: [4, 30] 或设置为 -1
注意
Seedance 2.5 系列支持两种配置方法
- 指定具体时长:支持有效范围内的任一整数。
- 智能指定:设置为 -1,表示由模型在有效范围内自主选择合适的视频长度(整数秒)。实际生成视频的时长可通过查询视频生成任务 API 返回的 duration 字段获取。注意视频时长与计费相关,请谨慎设置。
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, -1 "5"
Seedance 2.5 系列默认值:
720p
视频分辨率,枚举值:
- 480p
- 720p
480p, 720p Seedance 2.5 系列默认值为
adaptive
生成视频的宽高比例。不同宽高比对应的宽高像素值见下方表格。
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
- 21:9
- adaptive:根据输入自动选择最合适的宽高比(详见下文说明)
adaptive 适配规则
当配置 ratio 为 adaptive 时,模型会根据生成场景自动适配宽高比;实际生成的视频宽高比可通过查询视频生成任务 API 返回的 ratio 字段获取。
支持模型:
- Seedance 2.5 系列支持
取值规则:
- 首帧 / 首尾帧生视频:根据上传的首帧图片比例,自动选择最接近的宽高比。
不同宽高比对应的宽高像素值
注意:首尾帧生视频,选择的宽高比与您上传的图片宽高比不一致时,方舟会对您的图片进行裁剪,裁剪时会居中裁剪。
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive 输出视频格式。
- mp4:MP4 格式。
- mov:MOV 格式。
mp4, mov Seedance 2.5 系列暂不支持
种子整数,用于控制生成内容的随机性。取值范围:[-1, 2^32-1]之间的整数。
注意:
- 相同的请求下,模型收到不同的seed值,如:不指定seed值或令seed取值为-1(会使用随机数替代)、或手动变更seed值,将生成不同的结果。
- 相同的请求下,模型收到相同的seed值,会生成类似的结果,但不保证完全一致。
-1 <= x <= 4294967295生成视频是否包含水印。
- false:生成视频不含水印。
- true:生成视频右下角会展示 AI 生成 水印。
仅 Seedance 2.5 系列支持
控制生成的视频是否包含与画面同步的声音。
- true:模型输出的视频包含同步音频。模型会基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:"你记住,以后不可以用手指指月亮。"
- false:模型输出的视频为无声视频。
注意:生成的有声视频均为单声道,和传入的音频声道数无关。
true:返回生成视频的尾帧图像。设置为 true 后,可通过查询视频生成任务接口获取视频的尾帧图像。尾帧图像的格式为 png,宽高像素值与生成的视频保持一致,无水印。
使用该参数可实现生成多个连续视频:以上一个生成视频的尾帧作为下一个视频任务的首帧,快速生成多个连续视频。
false:不返回生成视频的尾帧图像。
终端用户的唯一标识符,用于协助平台检测您的应用中可能违反火山方舟使用政策的用户。该标识符为英文字符串,需保证对单个用户固定且唯一,长度不超过 64 个字符。推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串,避免泄露用户隐私信息。
响应
提交成功,返回视频任务对象。
视频生成任务 ID 。仅保存 7 天(从 created at 时间戳开始计算),超时后将自动清除。
- 设置 "draft": true,为 Draft 视频任务 ID。
- 设置 "draft": false,为正常视频任务 ID。
创建视频生成任务为异步接口,获取 ID 后,需要通过查询视频生成任务 API 来查询视频生成任务的状态。任务成功后,会输出生成视频的 video_url。