# Alibaba Cloud Viapi Videoenhan API

> Alibaba Cloud Viapi Videoenhan API on Apizie: 17 endpoints (This topic describes the syntax and examples of the AddFaceVideoTemplate operation for adding a video face…, Describes the syntax and examples of the AdjustVideoColor operation in the video production (videoenhan)…, Describes the syntax and examples of the ChangeVideoSize operation in the video production (videoenhan)…, This topic describes the syntax and examples of the DeleteFaceVideoTemplate operation for deleting a video…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-videoenhan`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/videoenhan
- Page: https://zieapi.vercel.app/api/cloud/aliyun-videoenhan
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-videoenhan/openapi.json

Alibaba Cloud OpenAPI for Viapi Videoenhan (videoenhan, version 2020-03-20). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### This topic describes the syntax and examples of the AddFaceVideoTemplate operation for adding a video face…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/add-face-video-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoURL | string | yes | The URL of the video template. Only OSS URLs in the China (Shanghai) region are supported. For information about how to generate a URL,… |
| VideoScene | string | no | The video face swap scenario. Valid values: single (default): single-person video face swap. multi: multi-person video face swap. If the… |

### Describes the syntax and examples of the AdjustVideoColor operation in the video production (videoenhan)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/adjust-video-color` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoUrl | string | yes | The URL of the video. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in other regions,… |
| VideoBitrate | integer | no | The bitrate of the output video. Unit: M. Default value: 20. Valid values: 8 to 200 |
| VideoCodec | string | no | The encoding format of the output video. Valid values: h264, hevc, and prores. Default value: h264 |
| VideoFormat | string | no | The format of the output video. Valid values: mp4 and mov. Default value: mp4 |
| Mode | string | no | The color grading mode. Default value: LogC. For more information, see Color grading modes |

### Describes the syntax and examples of the ChangeVideoSize operation in the video production (videoenhan)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/change-video-size` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoUrl | string | yes | The video URL. Use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other than China (Shanghai), see… |
| Width | integer | yes | The width of the output video. Unit: pixels. Valid values: 32 to 2160 |
| Height | integer | yes | The height of the output video. Unit: pixels. Valid values: 32 to 2160 |
| CropType | string | no | The cropping method. Valid values: smart: Intelligent cropping. Intelligently determines whether to pad or crop based on the position of… |
| FillType | string | no | The padding method. Valid values: image: Pads the video with the content of a middle frame, which is blurred before padding. color: Pads… |
| Tightness | number | no | The compactness of the cropping box. Valid values: 0 to 1. A larger value indicates that more content is cropped. Default value: 0.6 |
| R | integer | no | The R value in the RGB color model. This parameter is required when FillType is set to color |
| G | integer | no | The G value in the RGB color model. This parameter is required when FillType is set to color |
| B | integer | no | The B value in the RGB color model. This parameter is required when FillType is set to color |

### This topic describes the syntax and examples of the DeleteFaceVideoTemplate operation for deleting a video…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/delete-face-video-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| TemplateId | string | yes | The ID of the template to delete |

### Describes the syntax and examples of the EnhancePortraitVideo operation in the video production (videoenhan)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/enhance-portrait-video` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoUrl | string | yes | The URL of the input video. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored on your on-premises… |

### This topic describes the syntax and examples of the comprehensive video enhancement feature…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/enhance-video-quality` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoURL | string | yes | The URL of the input video. We recommend that you use an OSS link in the China (Shanghai) region. If the file is stored locally or the OSS… |
| OutPutWidth | integer | no | The width of the output video. Default value: twice the width of the input video. Unit: px. Valid values: `[180,7680]` |
| OutPutHeight | integer | no | The height of the output video. Default value: twice the height of the input video. Unit: px. Valid values: `[180,4320]` |
| FrameRate | integer | no | The frame rate of the output video. Default value: 50 fps. Valid values: `[1,120]` |
| HDRFormat | string | no | The HDR format of the output video. Only PQ and HLG are supported. Default value: PQ |
| MaxIlluminance | integer | no | The maximum luminance of the output video. Unit: nit. In PQ mode, this parameter is fixed at 600 nit and the input value is ignored. In… |
| Bitrate | integer | no | The bitrate of the output video. Unit: MB. Default value: 20 MB. Valid values: `[8,200]` |

### Describes the syntax and examples for the EraseVideoLogo operation in the Video Enhancement category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/erase-video-logo` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoUrl | string | yes | The video URL. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored locally or in OSS buckets in other… |
| Boxes | string | no | The position information of the logo areas (JSON-encoded) |

### Describes the syntax and examples of the EraseVideoSubtitles API operation in the video production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/erase-video-subtitles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoUrl | string | yes | The URL of the video. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other… |
| BX | number | no | The ratio of the x-coordinate of the upper-left corner of the subtitle area to the video width. Valid values: 0 to 1 |
| BY | number | no | The ratio of the y-coordinate of the upper-left corner of the subtitle area to the video height. Valid values: 0 to 1 |
| BW | number | no | The ratio of the width of the subtitle area to the video width. Valid values: 0 to 1 |
| BH | number | no | The ratio of the height of the subtitle area to the video height. Valid values: 0 to 1 |

### Describes the syntax and examples of the GenerateHumanAnimeStyleVideo operation for video portrait…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/generate-human-anime-style-video` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoUrl | string | yes | The video URL. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored locally or in OSS buckets in regions… |
| CartoonStyle | string | yes | The cartoon style. Valid values: anime: anime style 3d: 3D effect handdrawn: hand-drawn style sketch: pencil sketch artstyle: art effect |

### Describes the syntax and examples of the GenerateVideo operation in the video production (videoenhan) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/generate-video` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| Scene | string | no | The scene type of the generated video. Valid values: costume: clothing scene (default) general: general scene keeporder: forces the video… |
| Width | integer | no | The width of the output video. Valid values: 32 to 2160 |
| Height | integer | no | The height of the output video. Valid values: 32 to 2160. If neither width nor height is set, the output is 750 × 750. If only one of them… |
| Style | string | no | The rhythm of the output video. Valid values: normal, fast, and slow. Default value: normal |
| Duration | number | no | The duration of the output video, in seconds. Default value: 20. The minimum duration is 5 seconds and the maximum duration is 60 seconds |
| DurationAdaption | string | no | Specifies whether to enable adaptive duration for the output video. Valid values: true and false. If this parameter is set to true, the… |
| TransitionStyle | string | no | The shot transition style. A total of 15 styles are available. If this parameter is not set, the style is randomly selected based on the… |
| SmartEffect | string | no | Specifies whether to add smart effects. Default value: true. Currently, audio-video synchronization and static-to-dynamic effects are… |
| PuzzleEffect | string | no | Specifies whether to add dynamic puzzle effects, which support displaying multiple video and image materials through a puzzle in a single… |
| Mute | string | no | Specifies whether to mute the generated video. Default value: false. If no audio material is provided or the video material is silent, the… |
| FileList | string | yes | 1 (JSON-encoded) |

### This topic describes the syntax and examples of the GetAsyncJobResult operation for querying asynchronous…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/get-async-job-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| JobId | string | yes | The RequestId returned by the asynchronous operation. You can use this parameter to query the actual result of the asynchronous operation |

### Describes the syntax and examples of the InterpolateVideoFrame operation in the video production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/interpolate-video-frame` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoURL | string | yes | The URL of the input video. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in other… |
| FrameRate | integer | no | The frame rate of the output video. Default value: 50. Valid values: 1 to 120 |
| Bitrate | integer | no | The bitrate of the output video, in Mbps. Default value: 20. Valid values: 8 to 200 |

### Describes the syntax and examples of the MergeVideoFace operation for general video face swapping in the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/merge-video-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoURL | string | yes | The URL of the input video. We recommend that you use an OSS URL in the China (Shanghai) region. If the file is stored on your on-premises… |
| ReferenceURL | string | yes | The URL of the reference image for the replacement face. We recommend that you use an OSS URL in the China (Shanghai) region. If the file… |
| AddWatermark | string | no | Specifies whether to add a watermark. Valid values: True (default): Adds a watermark. False: Does not add a watermark |
| Enhance | string | no | Specifies whether to enable face beautification enhancement. Valid values: False (default): Does not enable face beautification… |
| WatermarkType | string | no | The watermark type. Valid values: EN (default): English watermark. CN: Chinese watermark |

### Describes the syntax and provides examples of the MergeVideoModelFace operation in the video production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/merge-video-model-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| TemplateId | string | yes | The template ID of the video face template |
| FaceImageURL | string | no | The URL of the replacement face reference image (required when TemplateId corresponds to a single-face template). FaceImageURL is used… |
| AddWatermark | string | no | Specifies whether to add a watermark. Valid values: True (default): Add a watermark. False: Do not add a watermark |
| Enhance | string | no | Specifies whether to enable face beautification enhancement. Valid values: False (default): Do not enable face beautification enhancement.… |
| WatermarkType | string | no | The watermark type. Valid values: EN (default): English watermark. CN: Chinese watermark |
| MergeInfos | string | no | The fusion parameters, including the face information of the template video and the user face image to be merged (required when TemplateId… |

### This topic describes the syntax and examples of the QueryFaceVideoTemplate operation for querying video face…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/query-face-video-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| TemplateId | string | no | The ID of the template to query. If TemplateId is not specified, the template list of the user is returned. If TemplateId is specified,… |
| PageNo | integer | no | The page number. Default value: 1. Valid values: 1 to 5000 |
| PageSize | integer | no | The number of entries per page. Default value: 100. Valid values: 1 to 500 |

### This topic describes the syntax and examples of the SuperResolveVideo operation for Video Ultra HD super…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/super-resolve-video` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |
| VideoUrl | string | yes | The URL of the input video. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions… |
| BitRate | integer | no | The bitrate of the output video. Unit: Mbit/s. Default value: 10. Valid values: 1 to 20 |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://videoenhan.cn-shanghai.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/add-face-video-template" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Viapi Videoenhan API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-videoenhan/add-face-video-template with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Viapi Videoenhan API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Viapi Videoenhan itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Viapi Videoenhan API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-videoenhan.

### What is the status of the Alibaba Cloud Viapi Videoenhan API?
Needs your own provider key (bring your own key)