# Alibaba Cloud Viapi Imageenhan API

> Alibaba Cloud Viapi Imageenhan API on Apizie: 18 endpoints (Describes the syntax and examples of the AssessComposition operation in the image production (imageenhan)…, Describes the syntax and examples of the AssessExposure operation in the image enhancement category, Describes the syntax and examples of the AssessSharpness operation in the image production (imageenhan)…, Describes the syntax and examples of the ChangeImageSize operation in the image production (imageenhan)…, …) 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-imageenhan/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for Viapi Imageenhan (imageenhan, version 2019-09-30). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Describes the syntax and examples of the AssessComposition operation in the image production (imageenhan)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/assess-composition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other… |

### Describes the syntax and examples of the AssessExposure operation in the image enhancement category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/assess-exposure` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. If the file is stored locally or in an OSS… |

### Describes the syntax and examples of the AssessSharpness operation in the image production (imageenhan)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/assess-sharpness` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. If the file is stored locally or in an OSS… |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| Width | integer | yes | The target width. Unit: pixels |
| Height | integer | yes | The target height. Unit: pixels |
| Url | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored locally or in OSS buckets in… |

### Describes the syntax and examples of the ColorizeImage operation in the imageenhan category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/colorize-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other… |

### Describes the syntax and examples for the EnhanceImageColor operation in the image production (imageenhan)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/enhance-image-color` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. Use an OSS URL in the China (Shanghai) region. If the file is stored on your on-premises machine or in an OSS bucket… |
| OutputFormat | string | yes | The output image format. Valid values: `png`, `jpg`, and `bmp` |
| Mode | string | yes | The color grading mode. Valid values: LogC, Rec709, and ln17_256. LogC: Suitable for flat images (low-contrast RAW images). It… |

### Describes the syntax and examples of the ErasePerson operation in the image production (imageenhan) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/erase-person` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in other regions,… |
| UserMask | string | yes | The URL of the mask image. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in other… |

### This topic describes the syntax and provides examples of the GenerateCartoonizedImage operation in the image…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/generate-cartoonized-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageUrl | string | yes | The URL of the input image. We recommend that you use an Object Storage Service (OSS) URL in the Shanghai region. If the file is stored… |
| ImageType | string | no | This field is deprecated |
| Index | string | yes | The cartoon effect. Valid values: 0: retro comic (default) 1: 3D fairy tale 2: anime 3: fresh and clean 4: futuristic tech 5: traditional… |

### Describes the syntax and examples of the GenerateSuperResolutionImage API in the Image Production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/generate-super-resolution-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageUrl | string | yes | The URL of the input image. Use an OSS URL in the China (Shanghai) region. For files stored on your on-premises machine or in an OSS… |
| Scale | integer | no | The upscaling factor of the image. Valid values: 1, 2, 3, and 4. Default value: 2 |
| UserData | string | no | This parameter is a reserved field for the operation and does not need to be specified by default |
| OutputFormat | string | no | The storage format of the output image. Valid values: `png`, `jpg`, and `bmp`. Default value: `png` |
| OutputQuality | integer | no | The quality factor of the output image. A larger value indicates higher quality. Valid values: [30,100]. Default value: 95. This parameter… |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.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 ImageBlindCharacterWatermark operation in the image production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/image-blind-character-watermark` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| FunctionType | string | yes | Specifies the feature to call. Valid values: encode_text: adds a text watermark by using the legacy model. encode_text_plus: adds a text… |
| Text | string | no | The text watermark to be added. The text can contain up to 16 characters. Exceeding this limit affects the watermark effect. This… |
| WatermarkImageURL | string | no | The URL of the image to be parsed, which is the composite image with the text watermark. We recommend that you use an OSS URL in the China… |
| OutputFileType | string | no | The format of the output image. Valid values: `png`, `jpg`, and `bmp`. Default value: `png`. This parameter is required when FunctionType… |
| QualityFactor | integer | no | The quality of the output image. A larger value indicates higher image quality. Valid values: 1 to 100. Default value: 100. This parameter… |
| OriginImageURL | string | no | The URL of the original image. We recommend that you use an OSS URL in the China (Shanghai) region. If the file is stored locally or the… |

### Describes the syntax and examples of the ImageBlindPicWatermark operation in the imageenhan category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/image-blind-pic-watermark` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| FunctionType | string | yes | Specifies the feature to call. Valid values: encode_pic: Adds an image watermark by using the legacy model. encode_pic_plus: Adds an image… |
| LogoURL | string | no | The URL of the watermark image to be added. We recommend that you use an OSS URL in the China (Shanghai) region. If the file is stored on… |
| WatermarkImageURL | string | no | The URL of the image to be parsed, which is the composite image containing the watermark. We recommend that you use an OSS URL in the… |
| OutputFileType | string | no | The format of the output image. Valid values: jpeg, png, jpg, and bmp. Default value: png. This parameter is required when FunctionType is… |
| QualityFactor | integer | no | The quality of the output image. A larger value indicates higher image quality. Valid values: 1 to 100. Default value: 100. This parameter… |
| OriginImageURL | string | no | The URL of the original image. We recommend that you use an OSS URL in the China (Shanghai) region. If the file is stored on your… |

### Describes the syntax and examples of the ImitatePhotoStyle API operation in the image production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/imitate-photo-style` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| StyleUrl | string | yes | The URL of the reference image. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored locally or in OSS… |
| ImageURL | string | yes | The URL of the image to be stylized. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored locally or in… |

### Describes the syntax and examples of the IntelligentComposition operation in the Image Generation…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/intelligent-composition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| NumBoxes | integer | no | The number of output boxes. Default value: 5. Valid values: 1 to 10. Values outside this range are truncated |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored locally or in OSS buckets… |

### Describes the syntax and examples of the MakeSuperResolutionImage operation in the image production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/make-super-resolution-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| Url | string | yes | The image URL. We recommend that you use an OSS URL in the China (Shanghai) region. For files stored locally or in OSS buckets outside the… |
| Mode | string | no | The image output mode. Default value: base. Valid values: base: the standard mode, which provides stable super-resolution effects.… |
| UpscaleFactor | integer | no | The upscaling multiplier. Valid values: 1, 2, 3, and 4. Default value: 2 |
| OutputFormat | string | no | The storage format of the output image. Valid values: png, jpg, and bmp. Default value: jpg. If the input image is in RGBA format, the… |
| OutputQuality | integer | no | The quality factor of the output image. A larger value indicates higher quality. Valid values: [30,100]. Default value: 95. This parameter… |

### Describes the syntax and examples of the RemoveImageSubtitles operation in the imageenhan category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/remove-image-subtitles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The image URL. We recommend that you use an OSS URL in the China (Shanghai) region. If the file is stored locally or in an OSS bucket in… |
| BX | number | no | The ratio of the x-coordinate of the upper-left corner of the subtitle area to the image 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 image height. Valid values: 0 to 1 |
| BW | number | no | The ratio of the width of the subtitle area to the image width. Valid values: 0 to 1 |
| BH | number | no | The ratio of the height of the subtitle area to the image height. Valid values: 0 to 1 |

### Describes the syntax and examples for the RemoveImageWatermark operation in the image production…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/remove-image-watermark` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageenhan.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other… |

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

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-imageenhan/assess-composition" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

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

### Is the Alibaba Cloud Viapi Imageenhan 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 Imageenhan itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Viapi Imageenhan 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-imageenhan.

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