# Alibaba Cloud Viapi Imageseg API

> Alibaba Cloud Viapi Imageseg API on Apizie: 16 endpoints (Describes the syntax and examples of the ChangeSky operation in the image segmentation (imageseg) category, This topic describes the syntax and examples of the GetAsyncJobResult operation for querying asynchronous…, Describes the syntax and examples of the RefineMask operation in the image segmentation (imageseg) category, Describes the syntax and examples of the SegmentBody operation in the image segmentation (imageseg) category, …) 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-imageseg/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

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

## Endpoints

### Describes the syntax and examples of the ChangeSky operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/change-sky` (byok)

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

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.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 RefineMask operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/refine-mask` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| MaskImageURL | string | yes | The URL of the rough mask image corresponding to the input image |
| 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 in… |

### Describes the syntax and examples of the SegmentBody operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-body` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The image URL. Use an OSS URL in the China (Shanghai) region. For files stored on your on-premises machine or in an OSS bucket outside the… |
| ReturnForm | string | no | Specifies the format of the returned image. If you set this parameter to `mask`, a single-channel black-and-white image is returned. If… |

### Describes the syntax and examples of the SegmentCloth operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-cloth` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.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… |
| OutMode | integer | no | The type of the returned segmentation result. This parameter affects the returned content of the ImageURL field and is optional. Valid… |
| ClothClass | string | no | The clothing category. Valid values: tops: Tops coat: Coats skirt: Skirts pants: Pants bag: Bags shoes: Shoes hat: Hats (JSON-encoded) |
| ReturnForm | string | no | The format of the returned image. Valid values: whiteBK: Returns an image with a white background. mask: Returns a single-channel mask. If… |

### This topic describes the syntax and provides examples of the commodity segmentation feature (SegmentCommodity)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-commodity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. We recommend that you use an OSS URL in the Shanghai region. If the file is stored locally or in an OSS bucket… |
| ReturnForm | string | no | The format of the returned image. If this parameter is not set, a 4-channel PNG image is returned. If this parameter is set to `mask`, a… |

### Describes the syntax and examples of the SegmentCommonImage operation in the image segmentation (imageseg)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-common-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The image URL. Use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other than China (Shanghai), see… |
| ReturnForm | string | no | Specifies the format of the returned image. If this parameter is not specified, a 4-channel PNG image is returned. If this parameter is… |

### Describes the syntax and examples of the SegmentFood operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-food` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image. Use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other than China (Shanghai),… |
| ReturnForm | string | no | Specifies the format of the returned image. If this parameter is not specified, a four-channel PNG image is returned. If this parameter is… |

### Describes the syntax and examples of the SegmentHDBody operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-hdbody` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The image URL. Use OSS URLs in the China (Shanghai) region. If your file is stored locally or in an OSS bucket outside the China… |

### Describes the syntax and examples of the SegmentHDCommonImage operation in the image segmentation (imageseg)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-hdcommon-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageUrl | string | yes | The image URL. Use an Object Storage Service (OSS) URL in the China (Shanghai) region. For local files or OSS URLs in other regions, see… |

### Describes the syntax and examples of the SegmentHDSky operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-hdsky` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The URL of the image in which you want to segment the sky. We recommend that you use an OSS URL in the China (Shanghai) region. If the… |

### Describes the syntax and examples for the SegmentHair operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-hair` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.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,… |

### Describes the syntax and examples of the SegmentHead operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-head` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.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 on your on-premises… |
| ReturnForm | string | no | Specifies the format of the returned image. If you set this parameter to `mask`, a single-channel mask is returned. If you do not set this… |

### Describes the syntax and examples of the SegmentSkin operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-skin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| URL | 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 on your on-premises… |

### Describes the syntax and examples of the SegmentSky operation in the image segmentation (imageseg) category
`POST https://zieapi.vercel.app/v1/cloud:aliyun-imageseg/segment-sky` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://imageseg.cn-shanghai.aliyuncs.com |
| ImageURL | string | yes | The image URL. Use an OSS URL in the China (Shanghai) region. For local files or OSS URLs in regions other than China (Shanghai), see… |

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

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

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

## FAQ

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

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

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

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