# 创建图生视频任务
#### 功能介绍
支持调用多模态视频大模型创建图生视频的推理任务。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/productdesc-pangulm/pangulm_01_0020.html)。
#### URI
POST /v1/{project_id}/alg-infer/aigc-img-video/service/{deployment_id}/videos
获取URI方式请参见[请求URI](https://support.huaweicloud.com/api-pangulm/pangulm_05_0004.html)。
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 用于获取操作API的权限。如[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)中响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type | 是    | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json                                                                                                                                                                       |
   
表2请求Body参数 
| 参数           | 是否必选 | 参数类型                                                     | 描述                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| model        | 否    | String                                                   | **参数解释：** 视频续写推理服务的lora ID，用于多lora场景的lora模型选择。 **约束限制：** 长度小于等于128。 **取值范围：** 不涉及。 **默认取值：** 多lora场景下，默认选择主模型。                                                |
| prompt       | 是    | String                                                   | **参数解释：** 提示词。 **约束限制：** 支持中英文。 **取值范围：** 长度小于等于1000。 **默认取值：** 不涉及。                                                                                     |
| image        | 否    | String                                                   | **参数解释：** 首帧图片base64或首帧图片URL。 **约束限制：** image字段和image_tail字段不能同时为空。 图片base64小于10M。 **取值范围：** 不涉及。 **默认取值：** 不涉及。        |
| image_tail   | 否    | String                                                   | **参数解释：** 尾帧图片base64或尾帧图片URL。 **约束限制：** image字段和image_tail字段不能同时为空。 图片base64小于10M。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| video_config | 否    | [VideoConfig] object | 生成视频的配置信息。                                                                                                                                                                                                                                                                                                                                                                                               |
   
 表3VideoConfig 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| resolution   | 否    | String | **参数解释：** 分辨率。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 720p                              |
| duration     | 否    | int    | **参数解释：** 生成的视频时长，单位秒。 **约束限制：** 无。 **取值范围：** 不涉及。 **默认取值：** 5                      |
| aspect_ratio | 否    | String | **参数解释：** 生成的视频宽高比。 **约束限制：** 不涉及。 **取值范围：** 16:9、9:16、4:3、3:4、1:1、original **默认取值：** 16:9 |
   
#### 响应参数
状态码：200
表4响应Body参数 
| 参数           | 参数类型                                                     | 描述                |
|:---|:---|:---|
| id           | String                                                   | 用来标识视频生成任务的唯一字符串。 |
| prompt       | String                                                   | 提示词。              |
| status       | String                                                   | 视频生成的任务状态。        |
| video_url    | String                                                   | 视频生成结果文件链接。       |
| video_config | [VideoConfig] object | 生成视频的配置信息。        |
   
**状态码： 400**
表5响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_msg  | String | 错误信息 |
| error_code | String | 错误码  |
   
#### 请求示例
```
POST https://{endpoint}/v1/{project_id}/alg-infer/aigc-img-video/service/{deployment_id}/videos
Request Header:   
Content-Type: application/json   
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
Request Body:
{
    "model": "pangu-mm-m2-aigvideo_xa6xu8.LoRA02",
    "prompt": "prompt",
    "image": "https://xxx.obs.cnxxx",
    "video_config": {
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
}
```
#### 响应示例
```
{
    "id": "e7c33de0-1245-42d9-a875-745845ce3b22",
    "prompt": "prompt",
    "status": "PROCESSING",
    "video_config": {
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。