# 创建文生视频任务
#### 功能介绍
根据用户输入提示词文本，生成视频。
**适用生数模型。**
#### 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_text2video、vidu/viduq3-turbo_text2video。 **默认取值：** 不涉及。 |
| input      | 是    | [input] object           | 输入基本信息，包含提示词等。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| parameters | 否    | [parameters] object | 视频处理参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表3input 
| 参数     | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| prompt | 是    | String | **参数解释：** 文本提示词，支持中英文。 **约束限制：** 不涉及。 **取值范围：** 文本最大长度为5000字符。 **默认取值：** 不涉及。 |
   
 表4parameters 
| 参数        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| size      | 否    | String  | **参数解释：** 生成视频的分辨率。 **约束限制：** 不涉及。 **取值范围：** 字段格式说明：传入字段格式为 1280\*720。 生成视频的分辨率档位，当前支持如下档位： - 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**
表5响应Body参数 
| 参数      | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| task_id | String | **参数描述：** 视频生成后的任务ID。 **取值范围：** 不涉及。 |
   
#### 请求示例
- 文生视频（vidu/viduq3-turbo_text2video 为例）- 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_text2video",
  "input": {
     "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。"
  },
  "parameters": {
    "size": "720*1280",
                    "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_text2video 为例）- 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_text2video",
  "input": {
     "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。"
  },
  "parameters": {
    "size": "720*1280",
                    "duration": 5,
    "audio": false
        }
      }'
  ```
  
 
#### 响应示例
**状态码：200**
视频生成任务创建成功。
```
{
  "task_id" : "964395715545571326"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | 视频生成任务创建成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/model-call-maas/model-call-035.html)。