生成视频(异步)

通过调用 视频模型 能力生成视频内容。支持多种视频生成方式，包括文本转视频、图像转视频等。注意此为异步接口，通过 查询异步结果 获取生成视频结果。

Authorizations

Authorization · string · header · required

使用以下格式进行身份验证：Bearer <your api key>

Body

application/json

CogVideoX-3

model · enum<string> · required

要调用的模型编码。

Available options:

cogvideox-3

prompt · string

视频的文本描述 视频的文本描述，字符长度不能超过512个字符, image_url和prompt二选一或者同时传入。

Example:

"A cat is playing with a ball."

quality · enum<string>

输出模式，默认为 speed。 quality：质量优先，生成质量高。 speed：速度优先，生成时间更快，质量相对稍低。

Available options:

speed,

quality

Example:

"speed"

with_audio · boolean

是否生成 AI 音效。默认值：False （不生成音效）。

Example:

false

watermark_enabled · boolean

控制AI生成图片时是否添加水印。

• true: 默认启用AI生成的显式水印及隐式数字水印，符合政策要求。
• false: 关闭所有水印，仅允许已签署免责声明的客户使用，签署路径：个人中心-安全管理-去水印管理

Example:

true

image_url

提供基于其生成内容的图像，如果传入此参数，系统将以该图像为基础进行操作。支持通过URL或Base64编码传入图片。图片要求如下：图片支持.png、.jpeg、.jpg 格式、图片大小：不超过5M, image_url和prompt二选一或者同时传入。 首尾帧：支持输入两张图，上传的第一张图片视作首帧图，第二张图片视作尾帧图，模型将以此参数中传入的图片来生成视频 首尾帧模式只支持speed 模式

Example:

"https://example.com/image.png"

size · enum<string>

默认值：若不指定，默认生成视频的短边为 1080，长边根据原图片比例确认。最高支持 4K 分辨率。

Available options:

1280x720,

720x1280,

1024x1024,

1920x1080,

1080x1920,

2048x1080,

3840x2160

Example:

"1920x1080"

fps · enum<integer>

视频帧率（FPS），可选值为 30 或 60。默认值：30。

Available options:

30,

60

Example:

30

duration · enum<integer>

视频持续时长，默认5秒，支持5、10

Available options:

5,

10

Example:

5

request_id · string

由客户端提供，必须唯一；用于区分每个请求的唯一标识符。如果客户端未提供，平台将默认生成一个。

user_id · string

终端用户的唯一 ID，协助平台干预终端用户违规、生成非法或不当信息或其他滥用行为。ID 长度要求：最少 6 个字符，最多 128 个字符。

Response

200

application/json

业务处理成功

model · string

此次调用使用的名称。

id · string

生成的任务ID，调用请求结果接口时使用此ID。

request_id · string

用户在客户端请求期间提交的任务编号或平台生成的任务编号。

task_status · string

处理状态，PROCESSING (处理中)、SUCCESS (成功)、FAIL (失败)。结果需要通过查询获取。