
# 上传图片或视频
#### 功能介绍
支持上传本地的图片或视频，得到图片或视频的URL，可以使用此图片URL执行图生视频任务，或使用视频URL执行视频续写任务。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/productdesc-pangulm/pangulm_01_0020.html)。
#### URI
POST /v1/{project_id}/common-obs-service/upload
获取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 | 发送的实体的Multipart类型，参数值为"multipart/form-data"。                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   
表2请求Body参数 
| 参数   | 是否必选 | 参数类型 | 描述                                                                                                                                             |
|:---|:---|:---|:---|
| file | 是    | File | **参数解释：** 待上传的图片或视频文件。 **约束限制：** 文件大小要小于200M。 |
   
#### 响应参数
状态码：200
表3响应Body参数 
| 参数          | 参数类型   | 描述        |
|:---|:---|:---|
| preview_url | String | 图片或视频URL。 |
   
**状态码： 400**
表4响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_msg  | String | 错误信息。 |
| error_code | String | 错误码。  |
   
#### 请求示例
```
POST https://{endpoint}/v1/{project_id}/common-obs-service/upload
Request Header:   
Content-Type: application/json   
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
Request Body:
{
    "file": xxx.mp4
}
```
#### 响应示例
```
{
    "preview_url": "https://xxx.obs.xxx/xxx.mp4?xxx"
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。
