文档中心

对象存储

媒体处理

VideoGeneration

VideoGeneration

功能描述

此接口用于将传入的文本信息和图片生成视频，包括文生视频和图生视频。

注意事项

该接口处于邀测状态，如需使用，请联系客户经理。

使用子账号操作时，请先在访问控制 > 权限策略中创建或编辑自定义策略，为当前桶添加 tos:CreateMediaProcessJobs 权限，再将该策略绑定至需要使用本功能的子账号。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
job_type	Query	String	是	VideoGeneration	任务类型，视频生成场景下取值仅为 VideoGeneration。
media_jobs	Query	String	是	-	代表媒体任务的请求特殊标识。

请求元素

名称	参数类型	是否必选	示例值	说明
Model	Container	是	-	豆包模型信息。
Name	String	是	doubao-seedance-1-0-pro	模型名称，当前线上配置支持 doubao-seedance-1-5-pro。父节点：Model
Version	String	否	251215	模型版本，Name 和 Version 用于生成 model ID，例如 doubao-seedance-1.5-pro-251215。说明 Version 为空时，默认使用系统推荐的版本。父节点：Model
Prompt	Container	是	-	视频生成提示信息。
Text	String	是	一位身穿绿色亮片礼服的女性站在粉红色背景前，周围飘落着五彩斑斓的彩纸	文生视频功能指定文本提示词，支持中英文，长度不能超过 500 字节。父节点：Prompt
Frames	[]String	否	[ "first-frame.png", "last-frame.png"]	图生视频功能指定图片（最多允许两张），支持以下方式：基于“首帧”方式（指定一张图片）基于“首尾帧”方式（指定两张图片）说明传入图片需要满足以下条件：图片格式：jpeg、png、webp、bmp、tiff、gif 宽高比（宽/高）：(0.4, 2.5) 宽高长度（px）：(300, 6000) 大小：小于 30MB 父节点：Prompt
Video	Container	是	-	输出视频信息。
Format	String	否	mp4	输出视频容器格式，目前固定取值 mp4。父节点：Video
Resolution		否	480p	输出视频分辨率，取值列表如下： 480p 720p（默认） 1080p 说明不同 Resolution 和 Ratio 参数组合，输出视频的宽高像素不一样，详情请参见不同分辨率和宽高比输出视频的宽高像素值。父节点：Video
Ratio		否	4:3	输出视频宽高比，取值列表如下： 16:9（默认） 4:3 1:1 3:4 9:16 21:9 说明不同 Resolution 和 Ratio 参数组合，输出视频的宽高像素不一样，详情请参见不同分辨率和宽高比输出视频的宽高像素值。父节点：Video
Duration	Integer	否	5	输出视频时长（秒），取值范围 [3, 12]。父节点：Video
Fps	Integer	否	24	视频帧率，目前固定取值 24。父节点：Video
Watermark	Boolean	否	true	生成视频是否包含水印。父节点：Video
CameraFixed	Boolean	否	true	是否固定摄像头。父节点：Video

不同分辨率和宽高比输出视频的宽高像素值

视频分辨率	视频宽高比
视频分辨率		16:9	4:3	1:1	3:4	9:16	21:9
480p	864×480	736×544	640×640	544×736	480×864	960×416
720p	1248×704	1120×832	960×960	832×1120	704×1248	1504×640
1080p	1920×1088	1664×1248	1440×1440	1248×1664	1088×1920	2176×928

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
Code	String	OK	状态码。
Message	String	Success	请求状态信息。
JobId	String	1852a9645b553232cdf10001fd35********	视频生成任务 ID。

请求示例

响应示例

最近更新时间：2026.09.16 11:14:20

这个页面对您有帮助吗？

有用

有用

无用

无用