文档首页/ MaaS模型即服务/ API参考/ 视频生成/ 生数模型/ 创建首尾帧视频生成任务
更新时间：2026-06-16 GMT+08:00
查看PDF
分享

创建首尾帧视频生成任务

功能介绍

根据用户传入的首尾帧图像和文本提示词，生成视频。适用生数模型。

URI

POST https://api.modelarts-maas.com/v1/video/generations

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

参数描述：

API Key 鉴权凭证，从 MaaS 控制台获取，调用推理API时从请求头 Authorization 字段传入，值格式为：Bearer MaaS_API_Key。
表2 请求Body参数

参数

是否必选

参数类型

描述

model

是

String

参数解释：

支持视频生成的模型名称。详情请参考视频生成模型。

约束限制：

不涉及。

取值范围：

vidu/viduq3-pro_start-end2video、vidu/viduq3-turbo_start-end2video

默认取值：

不涉及。

input

是

input object

输入基本信息，包含提示词、媒体素材等。

parameters

是

parameters object

视频处理参数。
表3 input

参数

是否必选

参数类型

描述

prompt

是

String

参数解释：

文本提示词，支持中英文。

约束限制：

不涉及。

取值范围：

文本最大长度为5000字符。

默认取值：

不涉及。

media

是

Array of media objects

媒体素材列表，图生视频情况下必填，用于指定视频生成所需的图像。

数组的每个元素为一个媒体对象，包含 type 与 url 字段。
表4 media

参数

是否必选

参数类型

描述

type

是

String

参数解释：

媒体素材类型。

约束限制：

不涉及。

取值范围：

  • first_frame：首帧图像（有且仅有1张）。

  • last_frame：尾帧图像（有且仅有1张）。

默认取值：

不涉及。

url

是

String

参数解释：

图像文件的URL地址。

约束限制：

  • 仅支持公网可访问URL。

  • 生数系列模型单个图片文件的大小不超过20MB。

取值范围：

不涉及。

默认取值：

不涉及。
表5 parameters

参数

是否必选

参数类型

描述

size

是

String

参数解释：

生成视频的分辨率。

约束限制：

不涉及。

取值范围：

字段格式说明：传入字段格式为 1280*720。

生成视频的分辨率档位，当前支持如下档位：

  • 生数系列（ViduQ3-Pro、ViduQ3-Turbo）

    • 540P档位：不同视频宽高比对应的分辨率如下。

      • 16:9：960*540

      • 9:16：540*960

    • 720P档位：不同视频宽高比对应的分辨率如下。

      • 16:9：1280*720

      • 9:16：720*1280

    • 1080P档位：不同视频宽高比对应的分辨率如下。

      • 16:9：1920*1080

      • 9:16：1080*1920

duration

否

Integer

参数解释：

生成视频时长，单位秒。

约束限制：

不涉及。

取值范围：

生数系列模型：[1, 16]。

默认取值：

生数系列模型：5。

seed

否

Integer

参数解释：

随机种子，用于控制生成内容的随机性。

约束限制：

不涉及。

取值范围：

  • 最小值：0

  • 最大值：2147483648

默认取值：

不涉及。

audio

否

Boolean

参数解释：

是否生成音频。

约束限制：

不涉及。

取值范围：

  • false：默认值，输出无声视频。

  • true：输出有声视频。

默认取值：

false，输出无声视频。

shot_type

否

String

参数解释：

指定生成视频的镜头类型，控制视频是由一个连续镜头还是多镜头组成。

约束限制：

不涉及。

取值范围：

  • single：默认值，生成单镜头视频。

  • multi：多镜头，系统会进行智能分镜。

默认取值：

single：生成单镜头视频。

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

task_id

String

参数描述：

视频生成后的任务ID。

取值范围：

不涉及。

请求示例

  • 图生视频（基于首尾帧）（vidu/viduq3-turbo_start-end2video 为例）- Python

    import requests
import json

if __name__ == '__main__':
    url = "https://api.modelarts-maas.com/v1/video/generations"  # API地址
    api_key = "MAAS_API_KEY"  # 把 MAAS_API_KEY 替换成已获取的API Key

    # Send request.
    headers = {
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {api_key}'
    }
    data = {
	  "model": "vidu/viduq3-turbo_start-end2video",
	  "input": {
		"prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。",
		"media": [
		  {
			"type": "first_frame",
			"url": "https://example/first_frame.jpg"
		  },
		  {
			"type": "last_frame",
			"url": "https://example/last_frame.jpg"
		  }
		]
	  },
	  "parameters": {
		"size": "1280*720",
		"duration": 5,
		"audio": False
	  }
	}
    response = requests.post(url, headers=headers, data=json.dumps(data), verify=False)

    # Print result.
    print(response.status_code)
    print(response.text)

  • 图生视频（基于首尾帧）（vidu/viduq3-turbo_start-end2video 为例）- Curl

    curl -X POST "https://api.modelarts-maas.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MAAS_API_KEY" \
  -d '{
	  "model": "vidu/viduq3-turbo_start-end2video",
	  "input": {
		"prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。",
		"media": [
		  {
			"type": "first_frame",
			"url": "https://example/first_frame.jpg"
		  },
		  {
			"type": "last_frame",
			"url": "https://example/last_frame.jpg"
		  }
		]
	  },
	  "parameters": {
		"size": "1280*720",
		"duration": 5,
		"audio": false
	  }
	}'

响应示例

状态码：200

视频生成任务创建成功。

{
  "task_id" : "962939796957712384"
}

状态码

状态码

描述

200

视频生成任务创建成功。

错误码

请参见错误码。

父主题： 生数模型

相关文档