---
title: "视频生成(异步)"
method: POST
path: "/paas/v4/videos/generations"
tags: ["模型 API"]
---

# 视频生成(异步)

`POST /paas/v4/videos/generations`

通过调用 [视频模型](/cn/guide/models/video-generation/cogvideox-3) 能力生成视频内容。支持多种视频生成方式，包括文本转视频、图像转视频等。注意此为异步接口，通过 [查询异步结果](/api-reference/%E6%A8%A1%E5%9E%8B-api/%E6%9F%A5%E8%AF%A2%E5%BC%82%E6%AD%A5%E7%BB%93%E6%9E%9C) 获取生成视频结果。点击 **Try it** 按钮可快速试用。

## Request body

- union
  - CogVideoX3Request
    - `prompt` string — 视频的文本描述，字符长度不能超过`512`个字符。`image_url` 和 `prompt` 不能同时为空。
    - `quality` 'speed' | 'quality' — 输出模式，默认为 `speed`。 `quality`：质量优先，生成质量高。 `speed`：速度优先，生成时间更快，质量相对稍低。
    - `with_audio` boolean — 是否生成 `AI` 音效。默认值：`False` （不生成音效）。
    - `watermark_enabled` boolean — 控制`AI`生成图片时是否添加水印。 - `true`: 默认启用`AI`生成的显式水印及隐式数字水印，符合政策要求。 - `false`: 关闭所有水印，仅允许已签署免责声明的客户使用，签署路径：个人中心-安全管理-去水印管理
    - `model` 'cogvideox-3', required — 要调用的模型编码。
    - `image_url` union
      - union
        - string, uri
        - string, byte
      - string[]
    - `size` '1280x720' | '720x1280' | '1024x1024' | '1920x1080' | '1080x1920' | '2048x1080' | '3840x2160' — 默认值：若不指定，默认生成视频的短边为 `1080`，长边根据原图片比例确认。最高支持 `4K` 分辨率。
    - `fps` 30 | 60 — 视频帧率（`FPS`），可选值为 `30` 或 `60`。默认值：`30`。
    - `duration` 5 | 10 — 视频持续时长，默认`5`秒，支持`5`、`10`
    - `request_id` string — 由客户端提供，必须唯一；用于区分每个请求的唯一标识符。如果客户端未提供，平台将默认生成一个。
    - `user_id` string — 终端用户的唯一 `ID`，协助平台干预终端用户违规、生成非法或不当信息或其他滥用行为。`ID` 长度要求：最少 `6` 个字符，最多 `128` 个字符。
  - CogVideoXRequest
    - `prompt` string — 视频的文本描述，最大输入长度为 `512` 个字符。必须提供 `image_url` 或 `prompt`，或两者都提供。
    - `quality` 'speed' | 'quality' — 输出模式，默认为 `speed`。 `quality`：质量优先，生成质量高。 `speed`：速度优先，生成时间更快，质量相对稍低。
    - `with_audio` boolean — 是否生成 `AI` 音效。默认值：`False` （不生成音效）。
    - `watermark_enabled` boolean — 控制`AI`生成图片时是否添加水印。 - `true`: 默认启用`AI`生成的显式水印及隐式数字水印，符合政策要求。 - `false`: 关闭所有水印，仅允许已签署免责声明的客户使用，签署路径：个人中心-安全管理-去水印管理
    - `model` 'cogvideox-2' | 'cogvideox-flash', required — 要调用的代码。
    - `image_url` union
      - string, uri
      - string, byte
    - `size` '720x480' | '1024x1024' | '1280x960' | '960x1280' | '1920x1080' | '1080x1920' | '2048x1080' | '3840x2160' — 默认：如果未指定，生成视频的短边默认为 `1080`，长边根据原始图像比例缩放。支持最高 `4K` 分辨率。分辨率选项：`720x480`、`1024x1024`、`1280x960`、`960x1280`、`1920x1080`、`1080x1920`、`2048x1080`、`3840x2160`。
    - `fps` 30 | 60 — 视频帧率（`FPS`），可选值为 `30` 或 `60`。默认：`30`。
    - `request_id` string — 由客户端提供，必须唯一；用于区分每个请求的唯一标识符。如果客户端未提供，平台将默认生成一个。
    - `user_id` string — 终端用户的唯一 `ID`，协助平台干预终端用户违规、生成非法或不当信息或其他滥用行为。`ID` 长度要求：最少 `6` 个字符，最多 `128` 个字符。
  - ViduText2VideoRequest
    - `model` 'viduq1-text', required — 要调用的代码。
    - `prompt` string, required — 视频的文本描述，最大输入长度为 `512` 个字符。
    - `style` 'general' | 'anime' — 风格 默认：`general` 可选值：`general`、`anime` `general`：通用风格，可以使用提示词控制定义风格。 `anime`：动漫风格，针对动漫特定视觉效果进行优化。可以使用不同的动漫主题提示词控制风格。
    - `duration` 5 — 视频时长参数。 默认：`5`，可选：`5`。
    - `aspect_ratio` '16:9' | '9:16' | '1:1' — 宽高比 默认：`16:9`，可选值：`16:9`、`9:16`、`1:1`
    - `size` '1920x1080' — 分辨率参数 默认：`1920x1080`，可选：`1920x1080`
    - `movement_amplitude` 'auto' | 'small' | 'medium' | 'large' — 运动幅度 默认：`auto`，可选值：`auto`、`small`、`medium`、`large`
    - `request_id` string — 由客户端提供，必须唯一；用于区分每个请求的唯一标识符。如果客户端未提供，平台将默认生成一个。
    - `user_id` string — 终端用户的唯一 `ID`，协助平台干预终端用户违规、生成非法或不当信息或其他滥用行为。`ID` 长度要求：最少 `6` 个字符，最多 `128` 个字符。
  - ViduImage2VideoRequest
    - `model` 'viduq1-image' | 'vidu2-image', required — 要调用的代码。
    - `prompt` string — 视频的文本描述，最大输入长度为 `512` 个字符。必须提供 `image_url` 或 `prompt`，或两者都提供。
    - `image_url` union
      - string, uri
      - string, byte
    - `duration` union
      - 5 — 视频时长参数。 默认：`5`，可选：`5`。
      - 4 — 视频时长参数。 默认：`4`，可选：`4`。
    - `size` union
      - '1920x1080' — 分辨率参数 默认：`1920x1080`，可选：`1920x1080`
      - '1280x720' — 分辨率参数 默认：`1280x720`，可选：`1280x720`
    - `movement_amplitude` 'auto' | 'small' | 'medium' | 'large' — 运动幅度 默认：`auto`，可选值：`auto`、`small`、`medium`、`large`
    - `with_audio` boolean — 为生成的视频添加背景音乐，仅当最终生成的视频时长为 `4`秒 时支持。
    - `request_id` string — 由客户端提供，必须唯一；用于区分每个请求的唯一标识符。如果客户端未提供，平台将默认生成一个。
    - `user_id` string — 终端用户的唯一 `ID`，协助平台干预终端用户违规、生成非法或不当信息或其他滥用行为。`ID` 长度要求：最少 `6` 个字符，最多 `128` 个字符。
  - ViduFrames2VideoRequest
    - `model` 'viduq1-start-end' | 'vidu2-start-end', required — 要调用的代码。
    - `prompt` string — 视频的文本描述，最大输入长度为 `512` 个字符。必须提供 `image_url` 或 `prompt`，或两者都提供。
    - `image_url` string[] — 图像 支持输入两张图像：第一张上传的图像将被视为第一帧，第二张图像作为最后一帧。模型将使用此参数中提供的图像来生成视频。 两张输入图像（第一帧和最后一帧）的分辨率必须相似，第一帧分辨率与最后一帧分辨率的比例应在 `0.8–1.25` 范围内。此外，图像宽高比必须小于 `1:4` 或 `4:1`。 支持图像 `URL` 或 `Base64` 编码的图像（确保可访问性；建议使用图像 URL）。 支持的格式：`png`、`jpeg`、`.jpg`、`webp`。 图像文件大小不得超过 `50 MB`。 注意：`Base64` 解码后，字节长度必须小于 `50MB`，编码必须包含适当的内容类型字符串，例如 `data:image/png;base64,{base64_encode}`。
    - `duration` union
      - 5 — 视频时长参数。 默认：`5`，可选：`5`。
      - 4 — 视频时长参数。 默认：`4`，可选：`4`。
    - `size` union
      - '1920x1080' — 分辨率参数 默认：`1920x1080`，可选：`1920x1080`
      - '1280x720' | '480x360' — 分辨率参数 默认：`1280x720`，可选：`1280x720`, `480x360`
    - `movement_amplitude` 'auto' | 'small' | 'medium' | 'large' — 运动幅度 默认：`auto`，可选值：`auto`、`small`、`medium`、`large`
    - `with_audio` boolean — 为生成的视频添加背景音乐。
    - `request_id` string — 由客户端提供，必须唯一；用于区分每个请求的唯一标识符。如果客户端未提供，平台将默认生成一个。
    - `user_id` string — 终端用户的唯一 `ID`，协助平台干预终端用户违规、生成非法或不当信息或其他滥用行为。`ID` 长度要求：最少 `6` 个字符，最多 `128` 个字符。
  - ViduReference2VideoRequest
    - `model` 'vidu2-reference', required — 要调用的代码。
    - `prompt` string — 视频的文本描述，最大输入长度为 `512` 个字符。必须提供 `image_url` 或 `prompt`，或两者都提供。
    - `image_url` string[] — 图像参考 支持输入 `1` 到 `3` 张图像。模型将使用此参数中提供的图像主题作为参考，生成具有一致主体的视频。 1. 支持图像 `URL` 或 `Base64` 编码的图像（确保可访问性；建议优先使用图像 URL）。 2. 支持的格式：`png`、`jpeg`、`.jpg`、`webp`。 3. 图像分辨率不得小于 `128x128`，宽高比必须小于 `1:4` 或 `4:1`。 4. 图像文件大小不得超过 `50 MB`。 5. 注意：`Base64` 解码后，字节长度必须小于 `50MB`，编码必须包含适当的内容类型字符串，例如 `data:image/png;base64,{base64_encode}`。
    - `duration` 4 — 视频时长参数。 默认：`4`，可选：`4`。
    - `aspect_ratio` '16:9' | '9:16' | '1:1' — 宽高比 默认：`16:9`，可选值：`16:9`、`9:16`、`1:1`
    - `size` '1280x720' — 分辨率参数 默认：`1280x720`，可选：`1280x720`
    - `movement_amplitude` 'auto' | 'small' | 'medium' | 'large' — 运动幅度 默认：`auto`，可选值：`auto`、`small`、`medium`、`large`
    - `with_audio` boolean — 为生成的视频添加背景音乐。
    - `request_id` string — 由客户端提供，必须唯一；用于区分每个请求的唯一标识符。如果客户端未提供，平台将默认生成一个。
    - `user_id` string — 终端用户的唯一 `ID`，协助平台干预终端用户违规、生成非法或不当信息或其他滥用行为。`ID` 长度要求：最少 `6` 个字符，最多 `128` 个字符。

## Response `200`

业务处理成功

- AsyncResponse
  - `model` string — 此次调用使用的名称。
  - `id` string — 生成的任务`ID`，调用请求结果接口时使用此`ID`。
  - `request_id` string — 用户在客户端请求期间提交的任务编号或平台生成的任务编号。
  - `task_status` string — 处理状态，`PROCESSING (处理中)`、`SUCCESS (成功)`、`FAIL (失败)`。结果需要通过查询获取。

## Other responses

- `default` — 请求失败。

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)