豆包的视频生成接口。
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
您需要调用的模型的 ID
输入给模型,生成视频的信息,支持文本、图片和视频(样片,Draft 视频)格式。支持以下几种组合: 文本 文本+图片 视频:其中视频指已成功生成的样片视频,模型可基于样片生成高质量正式视频。
信息类型
填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时,方舟将向此地址推送 POST 请求。 回调请求内容结构与查询任务API的返回体一致。 回调返回的 status 包括以下状态: queued:排队中。 running:任务运行中。 succeeded: 任务成功。(如发送失败,即5秒内没有接收到成功发送的信息,回调三次) failed:任务失败。(如发送失败,即5秒内没有接收到成功发送的信息,回调三次) expired:任务超时,即任务处于运行中或排队中状态超过过期时间。可通过 execution_expires_after 字段设置过期时间。
默认值 false true:返回生成视频的尾帧图像。设置为 true 后,可通过 查询视频生成任务接口 获取视频的尾帧图像。尾帧图像的格式为 png,宽高像素值与生成的视频保持一致,无水印。 使用该参数可实现生成多个连续视频:以上一个生成视频的尾帧作为下一个视频任务的首帧,快速生成多个连续视频,调用示例详见 教程。 false:不返回生成视频的尾帧图像。
指定处理本次请求的服务等级类型,枚举值: default:在线推理模式,RPM 和并发数配额较低(详见 模型列表),适合对推理时效性要求较高的场景。 flex:离线推理模式,TPD 配额更高(详见 模型列表),价格为在线推理的 50%, 适合对推理时延要求不高的场景。
任务超时阈值。指定任务提交后的过期时间(单位:秒),从 created at 时间戳开始计算。默认值 172800 秒,即 48 小时。取值范围:[3600,259200]。 不论使用哪种 service_tier,都建议根据业务场景设置合适的超时时间。超过该时间后任务会被自动终止,并标记为expired状态。
种子整数,用于控制生成内容的随机性。 取值范围:[-1, 2^32-1]之间的整数。
控制生成的视频是否包含与画面同步的声音。 true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。” false:模型输出的视频为无声视频。
控制是否开启样片模式。阅读文档 获取使用教程和注意事项。 true:开启样片模式,生成一段预览视频,快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期。消耗 token 数较正常视频更少,使用成本更低。 false:关闭样片模式,正常生成一段视频。
视频分辨率,枚举值: 480p 720p 1080p:参考图场景不支持
文生视频:默认值 16:9( Seedance 1.5 Pro 默认值为 adaptive)图生视频:默认值 adaptive(参考图生视频场景默认值为 16:9)生成视频的宽高比例。不同宽高比对应的宽高像素值见下方表格。 16:9 4:3 1:1 3:4 9:16 21:9 adaptive:根据输入自动选择最合适的宽高比
生成视频时长,单位:秒。支持 2~12 秒。
生成视频的帧数。通过指定帧数,可以灵活控制生成视频的长度,生成小数秒的视频。 由于 frames 的取值限制,仅能支持有限小数秒,您需要根据公式推算最接近的帧数。 计算公式:帧数 = 时长 × 帧率(24)。 取值范围:支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值,其中 n 为正整数。 例如:假设需要生成 2.4 秒的视频,帧数=2.4×24=57.6。由于 frames 不支持 57.6,此时您只能选择一个最接近的值。根据 25+4n 计算出最接近的帧数为 57,实际生成的视频为 57/24=2.375 秒。
生成视频是否包含水印。枚举值: false:不含水印。 true:含有水印。
仅文本输入模式