创建参考生视频生成任务
功能介绍
根据用户输入的参考图像和文本提示词，生成视频。适用生数模型。
URI
POST https://api.modelarts-maas.com/v1/video/generations
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数描述： API Key 鉴权凭证，从 MaaS 控制台获取，调用推理API时从请求头 Authorization 字段传入，值格式为：Bearer MaaS_API_Key。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| model | 是 | String | 参数解释： 支持视频生成的模型名称。详情请参考视频生成模型。 约束限制： 不涉及。 取值范围： vidu/viduq3-turbo_reference2video。 默认取值： 不涉及。 |
| input | 是 | input object | 输入基本信息，包含提示词、媒体素材等。 |
| parameters | 是 | parameters object | 视频处理参数。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| prompt | 是 | String | 参数解释： 文本提示词，支持中英文。 约束限制： 不涉及。 取值范围： 文本最大长度为5000字符。 默认取值： 不涉及。 |
| media | 是 | Array of media objects | 媒体素材列表，图生视频情况下必填，用于指定视频生成所需的图像。 数组的每个元素为一个媒体对象，包含 type 与 url 字段。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| type | 是 | String | 参数解释： 媒体素材类型。 约束限制： 不涉及。 取值范围： 默认取值： 不涉及。 |
| url | 是 | String | 参数解释： 图像文件的URL地址。 约束限制： 取值范围： 不涉及。 默认取值： 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| size | 是 | String | 参数解释： 生成视频的分辨率。 约束限制： 不涉及。 取值范围： 字段格式说明：传入字段格式为 1280*720。 生成视频的分辨率档位，当前支持如下档位： |
| duration | 否 | Integer | 参数解释： 生成视频时长，单位秒。 约束限制： 不涉及。 取值范围： 生数系列模型：[1, 16]。 默认取值： 生数系列模型：5。 |
| seed | 否 | Integer | 参数解释： 随机种子，用于控制生成内容的随机性。 约束限制： 不涉及。 取值范围： 默认取值： 不涉及。 |
| audio | 否 | Boolean | 参数解释： 是否生成音频。 约束限制： 不涉及。 取值范围： 默认取值： false，输出无声视频。 |
| shot_type | 否 | String | 参数解释： 指定生成视频的镜头类型，控制视频是由一个连续镜头还是多镜头组成。 约束限制： 不涉及。 取值范围： 默认取值： single：生成单镜头视频。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| task_id | String | 参数描述： 视频生成后的任务ID。 取值范围： 不涉及。 |
请求示例
-
图生视频（基于参考图）（vidu/viduq3-turbo_reference2video 为例）- 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_reference2video", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example/image1.jpg" }, { "type": "image_url", "url": "https://example/image2.jpg" }, { "type": "image_url", "url": "https://example/image3.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_reference2video 为例）- 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_reference2video", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example/image1.jpg" }, { "type": "image_url", "url": "https://example/image2.jpg" }, { "type": "image_url", "url": "https://example/image3.jpg" } ] }, "parameters": { "size": "1280*720", "duration": 5, "audio": false } }'
响应示例
状态码：200
视频生成任务创建成功。
{
"task_id" : "964395715545571329"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 视频生成任务创建成功。 |
错误码
请参见错误码。
