# 创建图生视频任务 #### 功能介绍 根据用户输入图像和提示词文本，生成视频。**适用爱诗模型。** #### 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 | **参数解释：** 支持视频生成的模型名称。 **约束限制：** 不涉及。 **取值范围：** pixverse/pixverse-v6-it2v。 **默认取值：** 不涉及。 | | input | 是 | [input] object | 输入基本信息，包含提示词、媒体素材等。 | | parameters | 是 | [parameters] object | 视频处理参数。 | 表3input | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | prompt | 是 | String | **参数解释：** 文本提示词，支持中英文。 **约束限制：** 不涉及。 **取值范围：** 爱诗系列图生视频模型文本最大长度为5000字符。 **默认取值：** 不涉及。 | | media | 是 | Array of [media] objects | 媒体素材列表，图生视频情况下必填，用于指定视频生成所需的图像。 数组的每个元素为一个媒体对象，包含 type 与 url 字段。 | 表4media | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | type | 是 | String | **参数解释：** 媒体素材类型。 **约束限制：** 不涉及。 **取值范围：** - image_url：图像URL。图生视频模型使用时，素材限制1张。 **默认取值：** 不涉及。 | | url | 是 | String | **参数解释：** 图像文件的URL地址。 **约束限制：** - 仅支持公网可访问URL。 - 支持的图片的格式：jpg、png、webp、jpeg。 - 爱诗系列模型单个图片文件的大小不超过20MB，10000px。 示例："url": "https://example.com/image.jpeg" **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表5parameters | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | resolution | 是 | String | **参数解释：** 生成视频的分辨率档位。 **约束限制：** 不涉及。 **取值范围：** 字段格式说明：如 720p 生成视频的分辨率档位，当前支持如下档位： - 爱诗系列（PixVerse V6） - 360P档位：360p - 540P档位：540p - 720P档位：720p - 1080P档位：1080p | | duration | 是 | Integer | **参数解释：** 视频时长，单位秒。 **约束限制：** 不涉及。 **取值范围：** 爱诗系列模型：\[1, 15\]。 **默认取值：** 爱诗系列模型：无默认值，必须填写。 | | seed | 否 | Integer | **参数解释：** 随机种子，用于控制生成内容的随机性。 **约束限制：** 不涉及。 **取值范围：** - 最小值：0 - 最大值：2147483648 **默认取值：** 不涉及。 | | audio | 否 | Boolean | **参数解释：** 是否生成音频。 **约束限制：** 不涉及。 **取值范围：** - false：默认值，输出无声视频。 - true：输出有声视频。 **默认取值：** false，输出无声视频。 | | shot_type | 否 | String | **参数解释：** 指定生成视频的镜头类型，控制视频是由一个连续镜头还是多镜头组成。 **约束限制：** 不涉及。 **取值范围：** - single：默认值，生成单镜头视频。 - multi：多镜头，系统会进行智能分镜。 **默认取值：** single：生成单镜头视频。 | #### 响应参数 **状态码：200** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | task_id | String | **参数描述：** 视频生成后的任务ID。 **取值范围：** 不涉及。 | #### 请求示例 - 图生视频（pixverse/pixverse-v6-it2v 为例）- 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": "pixverse/pixverse-v6-it2v", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example.com/image.jpeg" } ] }, "parameters": { "resolution": "720p", "duration": 5, "audio": False, "shot_type": "single" } } response = requests.post(url, headers=headers, data=json.dumps(data), verify=False) # Print result. print(response.status_code) print(response.text) ``` - 图生视频（pixverse/pixverse-v6-it2v 为例）- 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": "pixverse/pixverse-v6-it2v", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example.com/image.jpeg" } ] }, "parameters": { "resolution": "720p", "duration": 5, "audio": false, "shot_type": "single" } }' ``` #### 响应示例 **状态码：200** 视频生成任务创建成功。 ``` { "task_id" : "408732372621850", "resolution" : "720p", "duration" : 5, "audio" : false } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 视频生成任务创建成功。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/model-call-maas/model-call-035.html)。