# Alibaba Cloud AI-Driven Global E-commerce API

> Alibaba Cloud AI-Driven Global E-commerce API on Apizie: 56 endpoints (Synchronously adds content to a display knowledge base in batches, Generates virtual try-on images by applying a specified garment to a model image based on AI algorithms. The…, Provides a one-click cross-platform product listing optimization service for cross-border e-commerce sellers…, Provides a one-click cross-platform product listing optimization service for cross-border e-commerce sellers…, …) 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-aidge/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for AI-Driven Global E-commerce (aidge, version 2026-04-28). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Synchronously adds content to a display knowledge base in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/add-display-knowledge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| RagId | string | yes | The knowledge base ID |
| Records | string | yes | The records to add. A maximum of 500 records are supported (JSON-encoded) |

### Generates virtual try-on images by applying a specified garment to a model image based on AI algorithms. The…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/ai-try-on` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ModelImageUrl | string | yes | The URL of the model image. Only one image is supported. The URL must be a publicly accessible `http` or `https` address. The image must… |
| ClothImageUrl | string | yes | The URL of the garment image. Only one image is supported. The URL must be a publicly accessible `http` or `https` address. The image must… |
| ClothType | string | no | The type of the garment. Valid values: tops, bottoms, dresses, tops_and_bottoms, shoes, and hats. If this parameter is not specified, the… |
| Resolution | string | yes | The resolution of the output image. Synchronous API operations only support 1K resolution |

### Provides a one-click cross-platform product listing optimization service for cross-border e-commerce sellers…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/asset-optimize-lite` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ProductUrl | string | yes | The product URL |
| SourcePlatform | string | yes | The source platform, such as 1688 |
| TargetPlatform | string | yes | The target platform, such as temu |
| SourceLanguage | string | no | The source language code, such as zh |
| TargetLanguage | string | no | The target language code, such as en |
| NeedTrans | string | yes | Specifies whether translation is required |
| IncludingProductArea | string | no | Specifies whether product area translation is included |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate brand names in images. Default value: false |
| Glossary | string | no | The custom glossary for term intervention |

### Provides a one-click cross-platform product listing optimization service for cross-border e-commerce sellers…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/asset-optimize-pro` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ProductUrl | string | yes | The product URL. This parameter is required. Only 1688 product links are supported |
| SourcePlatform | string | yes | The source platform. Only 1688 is supported |
| TargetPlatform | string | yes | The target listing platform. Only temu is supported |
| SourceLanguage | string | no | The source language code. Optional. For supported language pairs, refer to the supported translation language list. This parameter is… |
| TargetLanguage | string | no | The target language code. Optional. For supported language pairs, refer to the supported translation language list. This parameter is… |
| NeedTrans | string | yes | Specifies whether translation is required (true/false). If set to true, SourceLanguage and TargetLanguage are required |
| IncludingProductArea | string | no | Specifies whether to translate text on the product subject area of images. Setting this to false helps protect embedded information such… |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate brand names on images. Optional. Default value: false. Setting this to false helps protect brand name… |
| Glossary | string | no | The glossary ID. Optional. Create a glossary in the console and provide its ID. If left empty, translation results are not modified by any… |
| Threshold | number | no | The confidence threshold for size chart detection. Default value: 0.4. A value of 0 treats all images as size charts. A value of 1 treats… |
| ColumnNameList | string | no | The list of column names to recognize in size chart images. Optional (JSON-encoded) |
| LanguageModel | string | no | The output language format for size chart images. If not specified, the original format is used. Set to en for English output or cn for… |

### Provides a cross-platform product category and attribute intelligent filling service based on multimodal…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/category-attribute-match` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourcePlatform | string | yes | The source platform from which the product originates |
| TargetPlatform | string | yes | The target listing platform. Currently, only temu is supported |
| Title | string | yes | The product title |
| SourceCategory | string | yes | The product category on the source platform |
| Description | string | no | The product details |
| Sku | string | yes | The product SKU title |
| ItemSpec | string | yes | The product attributes that describe the product characteristics |
| ImageUrl | string | no | The product image URLs. A maximum of 10 images are supported (JSON-encoded) |

### Provides an intelligent cross-platform product category matching service based on a large language model.…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/category-match` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourcePlatform | string | yes | The source platform from which products are sourced |
| TargetPlatform | string | yes | The target listing platform. Currently, only temu is supported |
| Title | string | yes | The product title |
| Description | string | yes | The product description |
| SourceCategory | string | yes | The product category on the source platform |
| Sku | string | no | The SKU title of the product |
| ItemSpec | string | no | The product attributes that describe the characteristics of the product, such as material. Provide the attribute names and values |

### Deletes display knowledge base content in batches synchronously
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/delete-display-knowledge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| RagId | string | yes | The knowledge base ID |
| RecordIds | string | yes | The IDs of the records to delete. You can specify up to 500 record IDs (JSON-encoded) |

### Calculates the edge lengths and floor area of a floor display based on the floor display image and product…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/didui-area-deduction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ReqId | string | no | The optional business request ID used for Tracing Analysis |
| TargetImageUrl | string | yes | The HTTPS URL of the overall floor display image |
| Products | string | yes | The list of products and their detection boxes (JSON-encoded) |
| RagId | string | no | The ID of the customer-specific SKU vector database that determines which database is used for recall. The database must be created in… |

### Analyzes the floor display area based on product recognition, SKU asset knowledge base, and a dedicated area…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/didui-area-deduction-pro` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTP(S) URL of the overall floor display image |
| RagId | string | yes | The ID of the SKU asset knowledge base |

### Designed specifically for document translation. Supports translation between more than 400 language pairs…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/document-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| Url | string | yes | The OSS URL of the document to be translated |
| TargetLanguage | string | yes | The target language. The language code uses the two-letter ISO 639-1 standard |
| FileType | string | yes | The type of the document. Valid values: PDF and word. Supported capacity limits: Word: 200 MB or 100 pages PDF: 200 MB or 100 pages… |
| Glossary | string | no | The glossary ID. Specify this parameter when you need the glossary feature. Supports custom translation results, including… |

### Creates an asynchronous task for e-commerce video variation generation, an AI video service for product…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/ecom-video-recreation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| Input | string | yes | The input parameters for video variation generation (JSON-encoded) |
| Output | string | no | The output specifications for the generated video (JSON-encoded) |

### Provides a general-purpose image review service built on recapture recognition and multimodal large model…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/general-rephotography-detection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTPS URL of the original image to recognize. The URL must be accessible and must not contain whitespace or URL-embedded usernames or… |

### Generates or rewrites e-commerce product copy, including titles, short highlights, search keywords, bullet…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/generate-product-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceText | string | yes | The product information or copy to be rewritten. The length must be 20 to 3,000 characters |
| ContentType | string | yes | The copy type. Valid values: title, highlight, keywords, bulletPoint, and description. When a platform is specified, you must select a… |
| ProductCategory | string | no | The product category. Default value: an empty string. The length must be 0 to 100 characters. It helps understand the category during… |
| ProductAttributes | string | no | The product attribute information. Default value: empty. The length must be 0 to 500 characters |
| Operation | string | yes | The operation type. Valid values: generate and rewrite |
| MinLength | integer | no | The minimum number of characters for the final output text. If specified, the value must be an integer greater than or equal to 10. If a… |
| MaxLength | integer | no | The maximum number of characters for the final output text. If specified, the value must be an integer greater than or equal to 30. If a… |
| EnableTranslation | string | no | Specifies whether to enable translation. Default value: false. Valid values: true and false |
| SourceLanguage | string | yes | The source language. Valid values: zh and en. Automatic language detection is not supported. Supported source languages: Chinese (zh) and… |
| TargetLanguage | string | no | Required when EnableTranslation is set to true. For valid values, see the multilingual processing section. If translation is disabled,… |
| Platform | string | no | The target platform. Valid values: amazon, temu, tiktok, shopify, Wildberries, and tmall. If this parameter is not provided, the request… |
| BulletPointCount | integer | no | Takes effect only when ContentType is set to bulletPoint. Valid values: 1 to 5. Default value in generate mode: 1. In rewrite mode, if… |

### Intelligently crops images to specified dimensions, automatically identifies the main subject area, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-cropping` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the image to process |
| TargetWidth | integer | yes | The target width |
| TargetHeight | integer | yes | The target height |

### Automatically identifies the salient subject in an image, separates the subject from the background, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-matting` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the original image. The image must be in JPG, JPEG, PNG, BMP, or WEBP format. The resolution must be between 256 × 256 and 3000… |
| BackGroundType | string | yes | Specifies the background type of the returned image. Valid values: WHITE_BACKGROUND: white background. TRANSPARENT: transparent background |
| TargetWidth | integer | no | The target image width in pixels |
| TargetHeight | integer | no | The target image height in pixels |
| BgColor | string | no | BGColor |

### Extracts the salient subject from an image by separating it from the background and returns the subject…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-matting-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the original image. The image must be in JPG, JPEG, PNG, BMP, or WEBP format. The resolution must be between 100 × 100 and 3000… |
| BackGroundType | string | yes | Specifies the background format of the returned image. Valid values: WHITE_BACKGROUND: Returns an image with a white background.… |
| TargetWidth | integer | no | The expected width of the cropped image. If you do not specify this parameter, the original width of the image is used. Unit: pixels.… |
| TargetHeight | integer | no | The expected height of the cropped image. If you do not specify this parameter, the original height of the image is used. Unit: pixels.… |
| BgColor | string | no | The BGR color value of the background. Default value: white |
| BizId | string | no | The business order ID of the caller. It is recorded upon acceptance and returned as is when you query the result of the asynchronous task |

### Intelligent element recognition
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-recognition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the image to recognize |
| ObjectDetectElements | string | no | The element types to detect on the image subject (1: watermark, 2: logo, 3: text, 4: text-containing color block). You can select multiple… |
| NonObjectDetectElements | string | no | The element types to detect on the non-subject area of the image (1: watermark, 2: logo, 3: text, 4: text-containing color block). You can… |
| ReturnCharacter | integer | no | Specifies whether to return text information. Valid values: 1 (return) and 0 (do not return) |
| ReturnBorderPixel | integer | no | Specifies whether to return border pixel information. Valid values: 1 (return) and 0 (do not return) |
| ReturnProductProp | integer | no | Specifies whether to return product attribute information. Valid values: 1 (return) and 0 (do not return) |
| ReturnProductNum | integer | no | Specifies whether to return the product count. Valid values: 1 (return) and 0 (do not return) |
| ReturnCharacterProp | integer | no | Specifies whether to return text attribute information. Valid values: 1 (return) and 0 (do not return) |

### Identifies specific elements in e-commerce images. It extracts image details to help users quickly identify…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-recognition-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The image URL. The image must be in JPG, JPEG, PNG, BMP, or WEBP format. The resolution must be between 256 × 256 and 3000 × 3000 pixels,… |
| ObjectDetectElements | string | no | The types of elements to detect on the image subject. Valid values: 1: watermark 2: logo 3: text 4: text-containing color block You can… |
| NonObjectDetectElements | string | no | The types of elements to detect outside the image subject. Valid values: 1: watermark 2: logo 3: text 4: text-containing color block You… |
| ReturnCharacter | integer | no | Specifies whether to return the OCR result of the text in the recognized area. Valid values: 1: yes 0: no Default value: 0 |
| ReturnBorderPixel | integer | no | Specifies whether to return the marginalization distance of the subject. Valid values: 1: yes 0: no Default value: 0 |
| ReturnProductProp | integer | no | Specifies whether to return the area proportion of the subject. Valid values: 1: yes 0: no Default value: 0 |
| ReturnProductNum | integer | no | Specifies whether to return the number of subjects. Valid values: 1: yes 0: no Default value: 0 |
| ReturnCharacterProp | integer | no | Specifies whether to return the text proportion. Valid values: 1: yes 0: no Default value: 0. This parameter takes effect only when the… |
| BizId | string | no | The business ID of the caller. It is recorded upon acceptance and returned as is when you query the result of the asynchronous task |

### Intelligently erases unwanted elements from e-commerce images, automatically identifying and removing text,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-removal-pro` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the image to process |
| Async | string | no | The call type. Valid values: true: Asynchronous. false: Synchronous. Default value: false |

### Removes objects from e-commerce images by automatically identifying and erasing text, specific names,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-removal-pro-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the original image. The image must be in the JPG, JPEG, PNG, BMP, or WEBP format. · Resolution: 256×256 to 3000×3000. File… |
| BizId | string | no | The business order ID of the caller. This ID is recorded when the request is accepted and returned as-is when you query the asynchronous… |

### Intelligently removes unwanted elements from e-commerce images. This product automatically identifies and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-remove` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the original image. The image must be in JPG, JPEG, PNG, BMP, or WEBP format, with a resolution between 256 × 256 and 3000 ×… |
| ObjectRemoveElements | string | no | The elements to remove from the image subject (1 = transparent text blocks, 2 = specific names, 3 = text, 4 = image blemishes). You can… |
| NonObjectRemoveElements | string | no | The elements to remove from the non-subject area of the image (1 = transparent text blocks, 2 = specific names, 3 = text, 4 = image… |
| Mask | string | no | The specific removal area. This parameter must be used with the editor. The input format is RLE. If specified, this parameter takes… |
| Position | string | no | The specific removal area. This parameter must be used with the editor. The input format is four-point coordinates [xx,yy,zz,dd]. This… |
| UserImage | string | no | The user-specified image element links to remove. Multiple image links are supported. The input format is… |
| UserText | string | no | The user-specified text to remove. Multiple text inputs are supported. The input format is ["xx","yy"]. This parameter is optional, but at… |

### Intelligently removes unwanted elements from e-commerce images by automatically identifying and erasing…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-remove-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the original image. The image must be in JPG, JPEG, PNG, BMP, or WEBP format. The resolution must be between 256 × 256 and 3000… |
| ObjectRemoveElements | string | no | The types of elements to remove from the image subject. Valid values: 1: Transparent text blocks. 2: Specific names. 3: Text. 4:… |
| NonObjectRemoveElements | string | no | The list of element types to remove from the image background (JSON-encoded) |
| Mask | string | no | The specific area to erase. This parameter must be used in conjunction with the editor. The input format is Run-Length Encoding (RLE). If… |
| Position | string | no | The specific area to erase. This parameter must be used in conjunction with the editor. The input format is a four-point coordinate array,… |
| UserImage | string | no | The list of URLs for user-specified image elements to erase (JSON-encoded) |
| UserText | string | no | The list of user-specified text strings to erase (JSON-encoded) |
| BizId | string | no | The business order ID of the caller. This ID is recorded when the request is accepted and returned as-is when you query the result of the… |

### Image Translation PLUS is designed specifically for e-commerce images and uses a Mixture of Experts (MOE)…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-translation-plus` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | yes | The source language. This parameter is required |
| TargetLanguage | string | yes | The target language. This parameter is required |
| ImageUrl | string | yes | The URL of the original image. This parameter is required |
| IncludingProductArea | string | no | Specifies whether to translate text on the product body. This parameter is optional. Default value: false |
| UseImageEditor | string | no | Specifies whether to use the image translation editor protocol. This parameter is optional |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate brand text on the product. This parameter is optional. Default value: false |
| Glossary | string | no | The ID of the intervention glossary. This parameter is optional |

### Translates e-commerce images by using the Mixture of Experts (MoE) architecture. Compared with the Lite and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-translation-plus-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | yes | The source language code. The value auto is supported for automatic detection |
| TargetLanguage | string | yes | The target language code. We recommend that you use the 12 minor language pairs listed above |
| ImageUrl | string | yes | Image URL: The image must be accessible over the Internet. Format: PNG, JPEG, JPG, BMP, or WEBP. Resolution: The width and height cannot… |
| IncludingProductArea | string | no | Specifies whether to translate the text on the image subject. This helps you protect information and prevent embedded information, such as… |
| UseImageEditor | string | no | Specifies whether to return layout information such as the position, font, and color of the text. This can be used to obtain data when you… |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate the brand name in the image. This prevents the brand name from being translated. Default value: false. In… |
| Glossary | string | no | The intervention glossary ID. You must create the intervention glossary separately and provide its ID in the input parameters. If the… |
| BizId | string | no | The business order ID of the caller. This ID is recorded when the request is accepted and returned as is when you query the asynchronous… |

### Translates images using the Pro edition, which is designed for e-commerce images. This edition integrates…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-translation-pro` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | yes | The source language code. This parameter is required. For supported language directions, see Language direction mapping… |
| TargetLanguage | string | yes | The target language code. This parameter is required. For supported language directions, see Language direction mapping… |
| ImageUrl | string | yes | The URL of the original image. This parameter is required. Image requirements: Image URL: The URL must be publicly accessible. Format:… |
| IncludingProductArea | string | no | Specifies whether to translate text on the image subject. This parameter is optional. Default value: false. Setting this parameter to… |
| UseImageEditor | string | no | Specifies whether to return layout information such as text position, font, and color. When set to true, layer information is returned,… |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate brand names on images. This parameter is optional. Default value: false. Setting this parameter to false… |
| Glossary | string | no | The ID of the intervention glossary. This parameter is optional. Create the glossary separately in the console and provide its ID. If the… |
| Async | string | no | Specifies whether to use asynchronous mode. Default value: false (synchronous mode). When set to true, the API immediately returns a… |

### Translates images asynchronously by using Image Translation Pro. Designed for e-commerce images, this…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-translation-pro-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | yes | The source language code. The value auto is supported for automatic detection |
| TargetLanguage | string | yes | The target language code. For supported language pairs, see the appendix |
| ImageUrl | string | yes | • Image URL: The URL must be publicly accessible over the Internet. • Formats: PNG, JPEG, JPG, BMP, and WEBP. • Pixels: The width and… |
| IncludingProductArea | string | no | Specifies whether to translate the text on the image subject. Set this parameter to false to protect the subject information, such as the… |
| UseImageEditor | string | no | Specifies whether to return layout information such as the position, font, and color of the text. If you set this parameter to true, layer… |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate brand names in the image. Default value: false, which indicates that brand names are not translated |
| Glossary | string | no | The ID of the intervention glossary. You must create the glossary in the console and provide its ID. If this parameter is left empty, the… |
| BizId | string | no | The business ID of the caller. This ID is recorded when the request is accepted and returned as-is when you query the asynchronous task… |

### Translates text in images with support for over 400 language directions (including bridging). This product…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-translation-standard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | Image URL: Must be publicly accessible. Format: png, jpeg, jpg, bmp, or webp. Pixels: Both width and height must not exceed 4000. File… |
| SourceLanguage | string | yes | The source language code. This parameter is required. For supported language directions, see Language direction mapping… |
| TargetLanguage | string | yes | The target language code. This parameter is required. For supported language directions, see Language direction mapping… |
| IncludingProductArea | string | no | Specifies whether to translate text on the image subject. This parameter is optional. Default value: false. This helps protect information… |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate brand names on the image. This parameter is optional. Default value: false. This helps protect brand name… |
| Glossary | string | no | The intervention glossary ID. This parameter is optional. You must create the glossary separately in the console and provide its ID. If… |
| UseImageEditor | string | no | Specifies whether to return layer information such as text position, font, and color. If this parameter is set to true, layer information… |

### Translates images specifically designed for e-commerce, supporting over 400 language pairs, including…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/image-translation-standard-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the image to be translated |
| SourceLanguage | string | yes | The source language |
| TargetLanguage | string | yes | The target language |
| IncludingProductArea | string | no | Specifies whether to include the translation of the product area |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate the brand text in the product area |
| Glossary | string | no | The intervention glossary |
| UseImageEditor | string | no | Specifies whether to use the image editor protocol |
| BizId | string | no | The business order ID of the caller. It is recorded upon acceptance and returned as-is when querying the asynchronous task result |

### Supports automatic language identification for 31 languages in query scenarios and 35 languages in general…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/language-detect` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceText | string | yes | The source text to identify. This parameter is required |
| Scene | string | no | The detection scenario. Default value: common. If you are identifying search phrases, set this parameter to query. If an incorrect value… |

### Material display detection is an intelligent compliance detection capability for in-store marketing…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/material-inspection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| Rules | string | no | The rule prompt in natural language |
| ImageUrl | string | yes | The URL of the target image |
| ImageRefer | string | no | The URL of the reference image. This parameter is optional. If a non-empty value is specified, multi-image differential comparison is… |
| ReqId | string | no | The business request identity. This parameter is optional. The value is returned as-is in the response for Tracing Analysis purposes |
| ApiId | string | no | apiId |

### Detects and identifies products displayed on store shelves or floor stacks by using a multimodal large…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/merchandise-placement-detection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the original shelf or floor stack image to be recognized (accessible over the Internet or through OSS) |
| RagId | string | no | The ID of the customer-specific SKU vector library, which determines which library is used for retrieval. The library must be created in… |
| Type | string | no | The business type (reserved for future routing by business line). The current release supports skincare & lotion |
| ApiId | string | no | Specify this parameter to use a custom API version. If you created a custom API during the trial phase, you can find the corresponding… |
| Rule | string | no | The custom rule. Enter a detection prompt as the workflow input parameter rule. When this parameter is specified, the type parameter is… |

### Detects product displays in photos of shelves, endcaps, freezers, display tables, and dump bins by using…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/merchandise-placement-detection-lite` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTPS URL of the display image to be detected |

### Detects the positions and names of visible products in an image based on a dedicated visual model. The…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/merchandise-placement-detection-pro` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTPS URL of the display image to detect |
| Rule | string | no | The detection rule. When non-empty, this value takes priority as the model prompt |
| Type | string | no | The product type. This parameter must be set to Genki Forest when Rule is empty |

### Detects display price tags based on price tag recognition and multimodal large model localization,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/merchandise-price-tag-detection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTP(S) URL of the image to be detected |

### Detects store displays based on display scene recognition and holistic positioning powered by multimodal…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/merchandise-scene-detection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTP(S) URL of the display image to be detected |

### Reviews images of milk powder can bottom codes by using recapture detection and multimodal large model-based…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/milk-powder-can-bottom-code-rephotography-detection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTP(S) URL of the image to be detected |

### Reviews infant formula carton code images based on recapture detection and element localization using…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/milk-powder-carton-code-rephotography-detection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTP(S) URL of the image to be analyzed |

### An intelligent logistics parcel review product built on the collaboration of a multimodal large language…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/package-weight-size-check` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| RawImageUrl | string | yes | The URL of the raw image, which is the unannotated photo of the parcel on the scanning platform. The URL must be publicly accessible. The… |
| AnnotatedImageUrl | string | yes | The URL of the image with manual bounding box annotations, which is the original image overlaid with blue or red rectangular bounding box… |

### Maas-MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/prepaid-text-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | no | The source language code. This parameter is optional. If not specified, the language is automatically detected. You can pass auto for… |
| TargetLanguage | string | yes | The target language code. This parameter is required. More than 100 language directions are supported. For details, refer to the supported… |
| SourceTextList | string | yes | The list of texts to translate. This parameter is required. The total character length cannot exceed 50,000, and the list length cannot… |
| Glossary | string | no | The intervention glossary ID. This parameter is optional. The glossary must be created separately in the console, and its ID must be… |
| FormatType | string | no | The format type of the source text. This parameter is optional. Valid values: text (plain text format) and html (web page format that… |
| TranslateScene | string | no | The format of the translation text. Valid values: html (web page format. This setting processes both the source text and translated text… |
| BizName | string | no | The business scenario identifier. This parameter is optional. Valid values: e-commerce-title, e-commerce-description, e-commerce-chat,… |

### Automatically identifies and locates specified products in an image based on a multimodal foundation model
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/product-hotspot-detection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ReqId | string | no | The unique business ID for this single-scene call |
| TargetImageUrl | string | yes | The HTTPS OSS or CDN URL of the target image to be annotated with bounding boxes |
| ReferenceImageUrls | string | yes | The HTTPS URLs of reference images that define the SKU whitelist. A maximum of 20 images are supported (JSON-encoded) |

### Queries the result of an asynchronous task. The API name in the POP gateway is QueryAsyncTaskResult
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/query-async-task-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| TaskId | string | no | The ID of the asynchronous task. This parameter is required |

### Performs a paged query on the content of a display knowledge base with paging (synchronization)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/query-display-knowledge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| RagId | string | yes | The knowledge base ID |
| SkuId | string | no | The SKU ID for exact match |
| SkuName | string | no | The keyword in the SKU name |
| Statuses | string | no | The list of record statuses. Valid values: UPDATING, EMBEDDED, and FAILED (JSON-encoded) |
| PageNum | integer | no | The page number. Default value: 1 |
| PageSize | integer | no | The number of entries per page. Default value: 20. Maximum value: 100 |

### Detects whether an image contains a size chart. (Synchronous)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/size-chart-detect` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the image to detect |
| Threshold | number | no | The detection threshold. Valid values: 0 to 1 |

### Intelligently extracts structured information such as size charts and package weight/dimension data from…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/size-chart-extract` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the size chart image to extract |
| ColumnNameList | string | no | The list of column names (such as Size, Bust, and Length) (JSON-encoded) |
| LanguageModel | string | no | The language model (such as en and cn) |

### Extracts structured information such as size charts and package weight and dimensions from images by using…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/size-chart-extract-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The image URL. The image must be in the JPG, JPEG, PNG, BMP, or WEBP format. The resolution must be between 256 × 256 pixels and 3000 ×… |
| ColumnNameList | string | no | The list of column names to extract, such as Size, Bust, and Length (JSON-encoded) |
| LanguageModel | string | no | The output language format. If you do not specify this parameter, the original language is used. If the original image language is Chinese… |
| BizId | string | no | The business order number of the caller. It is recorded when the request is accepted and returned as is when you query the asynchronous… |

### Reviews store photos based on storefront scene recognition and multimodal large model element localization.…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/storefront-scene-recognition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The HTTP(S) URL of the image to be reviewed |

### Generates product detail page assets automatically based on a multimodal large language model (MLLM) and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/submit-product-match` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ItemId | string | yes | The Miaojie product ID |
| Title | string | yes | The product title |
| ImageUrl | string | yes | The HTTP or HTTPS URL of the product main image |
| ShopName | string | yes | The shop name. This value is also used as the extraction source when the brand name is missing |
| BrandName | string | no | The product brand. If this value is not specified, the system attempts to extract the brand from the shop name |
| ProductUrl | string | no | The HTTP or HTTPS URL of the product detail page |
| Category | string | no | The Miaojie product category. Currently used for extension and auditing purposes |

### Corrects errors in search terms and titles
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/text-correct` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceText | string | yes | The text to correct. This parameter is required |
| SourceLanguage | string | yes | The source language code. This parameter is required. You can set this parameter to auto for automatic language detection. 14 languages… |

### Maas-MT is an e-commerce translation model trained on over 1 billion high-quality bilingual sentence pairs,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/text-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | no | The source language code. If this parameter is not specified, the language is automatically detected. This parameter is optional. You can… |
| TargetLanguage | string | yes | The target language code. This parameter is required. For supported language directions, see Language direction mapping… |
| SourceTextList | string | yes | The list of texts to translate. This parameter is required. The total character length cannot exceed 50,000, and the list length cannot… |
| Glossary | string | no | The intervention glossary ID. This parameter is optional. The glossary must be created separately in the console, and its ID must be… |
| FormatType | string | no | The format type of the source text. This parameter is optional. Valid values: text (plain text format) and html (web page format, which… |
| TranslateScene | string | no | The business scenario identifier. You can pass only one of the following values. When specified, the translation engine invokes the… |
| BizName | string | no | This field represents your identity and facilitates subsequent communication on various issues. If you are an Alibaba internal… |

### Translates text by using the Maas MT model, an e-commerce translation model trained on over 1 billion…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/text-translate-async` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | no | The source language code. For more information, see the supported language list below. If this parameter is not specified, the language is… |
| TargetLanguage | string | yes | The target language code. For more information, see the supported language pair list below |
| SourceTextList | string | yes | The list of texts to be translated (JSON-encoded) |
| FormatType | string | no | The format type of the source text. Valid values: text and html |
| Glossary | string | no | The ID of the intervention glossary. You must create the glossary in the console and provide its ID in the request parameters. If the… |
| TranslateScene | string | no | The business scenario identifier. You can specify only one of the following values. After you specify a value, the translation engine uses… |
| BizName | string | no | The business name of the caller. This field represents your identity and facilitates subsequent communication. If you are an internal… |
| BizId | string | no | The business ID of the caller. The maximum length is 128 characters. This ID is passed through in the translation results |

### Synchronously updates the content of a display knowledge base in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/update-display-knowledge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| RagId | string | yes | The knowledge base ID |
| Records | string | yes | The records to update. A maximum of 500 records can be specified (JSON-encoded) |

### The e-commerce AI video generation agent is designed for e-commerce merchants and platforms. Based on…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/video-generation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| Input | string | yes | The product input (JSON-encoded) |
| Intent | string | no | The intent parameters. Currently unavailable (JSON-encoded) |
| Output | string | yes | The output parameters (JSON-encoded) |

### Translates the speech and on-screen text in a video into a target language. You can select speech subtitle…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/video-translation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| VideoUrl | string | yes | The video URL. Supported formats: MP4 and MOV. Maximum size: 200 MB |
| TargetLanguage | string | no | Required when speech is included. Optional when only visual is included and EraseOnly is set to true. If specified in this case, it is… |
| SourceLanguage | string | no | The original language of the video (source language). For supported languages, see Language support |
| Capabilities | string | yes | The list of translation features. Valid values: speech and visual. You can select both. At least one feature is required. Duplicate values… |
| SubtitleMode | string | no | Applicable only when speech is included. Valid values: erase: erases the original subtitles only. replace: replaces the original subtitles… |
| EraseOnly | string | no | Applicable only when visual is included. Specifies whether to erase on-screen text without translation. Valid values: true: erases… |
| RemoveLogo | string | no | Applicable only when visual is included. Specifies whether to erase brand logos. Valid values: true: erases brand logos. false: retains… |
| EnableQualityCheck | string | no | Specifies whether to enable quality inspection for on-screen text processing. Effective only when visual is included and this parameter is… |

### Generates virtual try-on images based on AI algorithms. This API service replaces the clothing on a model…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/virtual-try-on` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ModelImageUrl | string | yes | The URL of the model image. Only one image is supported. The URL must be a publicly accessible `http`/`https` address. The image must be… |
| ClothImageUrl | string | yes | The URL of the garment image. Only one image is supported. The URL must be a publicly accessible `http`/`https` address. The image must be… |
| ClothType | string | no | The garment type. Valid values: tops, bottoms, dresses, tops_and_bottoms, shoes, and hats. If this parameter is not specified, the system… |
| Resolution | string | yes | Required. The image resolution. Valid values: 1K and 2K |

### Provides a one-stop AI-powered image processing service for e-commerce sellers. Orchestrates seven atomic…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/vision-flow` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | yes | The URL of the image to process. This parameter is required. Resolution must be greater than 256 × 256, long side no greater than 1920… |
| Ability | string | yes | The AI capabilities to apply (1 = Intelligent Element Detection, 2 = Intelligent Matting, 3 = Intelligent Removal, 4 = Image Translation… |
| ObjectDetectElements | string | no | The elements to detect on the image subject (1 = Watermark, 2 = Logo, 3 = Text, 4 = Text-bearing color block). Multiple selections… |
| NonobjectDetectElements | string | no | The elements to detect on the non-subject area of the image (1 = Watermark, 2 = Logo, 3 = Text, 4 = Text-bearing color block). Multiple… |
| IsFilter | string | no | Specifies whether images with the detected elements proceed to subsequent processing. A value of true indicates that images containing the… |
| BackGroundType | string | no | The background type of the output image. Valid values: WHITE_BACKGROUND (white background) and TRANSPARENT (transparent background). This… |
| ObjectRemoveElements | string | no | The elements to remove from the image subject (1 = Transparent text block, 2 = Specific name, 3 = Text, 4 = Overlay patch). Multiple… |
| NonobjectRemoveElements | string | no | The elements to remove from the non-subject area of the image (1 = Transparent text block, 2 = Specific name, 3 = Text, 4 = Overlay… |
| Mask | string | no | The specific removal region in RLE format. Optional. If provided, this parameter takes priority and the ObjectRemoveElements and… |
| SourceLanguage | string | no | The source language code. Optional. For supported language pairs, refer to the supported translation language pairs list |
| TargetLanguage | string | no | The target language code. Optional. For supported language pairs, refer to the supported translation language pairs list |
| IncludingProductArea | string | no | Specifies whether to translate text on the image subject. Optional. Default value: false. Helps protect embedded information such as… |
| TranslatingBrandInTheProduct | string | no | Specifies whether to translate brand names in the image. Optional. Default value: false. Helps protect brand name information from being… |
| Glossary | string | no | The glossary ID. Optional. Create a glossary separately in the console and provide its ID. If left empty, translation results are not… |
| TargetWidth | integer | no | The desired width of the cropped image, in pixels. Valid values: 100 to 5000. This parameter is required when the Intelligent Cropping… |
| TargetHeight | integer | no | The desired height of the cropped image, in pixels. Valid values: 100 to 5000. This parameter is required when the Intelligent Cropping… |
| UpscaleFactor | integer | no | The image upscaling factor. Optional. Default value: 2. Valid values: 2 to 4. This parameter is required when the HD Upscaling capability… |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aidge.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-aidge/add-display-knowledge" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud AI-Driven Global E-commerce API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-aidge/add-display-knowledge with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud AI-Driven Global E-commerce 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-aidge.

### What is the status of the Alibaba Cloud AI-Driven Global E-commerce API?
Needs your own provider key (bring your own key)