# Alibaba Cloud AgentRetailVision API

> Alibaba Cloud AgentRetailVision API on Apizie: 7 endpoints (Generates image groups for a single item with multiple images or for multiple items, Creates product information for a business. After a successful import, the platform returns a globally…, At least one result retrieval method must be configured: webhook callback or task status polling. Both…, Creates an asynchronous recognition task for intelligent recognition scenarios by using the OSS URL of a…, …) 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-agentretailvision/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for AgentRetailVision (agentretailvision, version 2026-05-06). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Generates image groups for a single item with multiple images or for multiple items
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentretailvision/generate-group-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentretailvision.cn-beijing.aliyuncs.com |
| GroupId | string | no | The image group request ID generated by the caller |
| GroupType | integer | no | The image group type. Valid values: 1: image group for a single SKU with multiple images. 2: image group for multiple SKUs |
| PlatformItemIdList | string | no | The list of platform item IDs, which correspond to smart_retail_item.platform_item_id (JSON-encoded) |
| ImageUrlList | string | no | The list of image URLs used for single SKU image groups. This parameter is required when groupType is set to 1. A maximum of 10 images are… |

### Creates product information for a business. After a successful import, the platform returns a globally…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentretailvision/import-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentretailvision.cn-beijing.aliyuncs.com |
| ItemUniqueId | string | no | The product ID of the business. This ID must be unique within the same business |
| ImageTitle | string | no | The product title |
| MainImage | string | no | The list of main product image URLs. At least one URL is required (JSON-encoded) |
| MultiViewImages | string | no | The list of multi-view product images (JSON-encoded) |
| ExtraImages | string | no | The list of additional image URLs that can be provided (JSON-encoded) |
| DeviceId | string | no | The device ID, which is used to establish an association between the device and the product vector |

### At least one result retrieval method must be configured: webhook callback or task status polling. Both…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentretailvision/query-recognition-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentretailvision.cn-beijing.aliyuncs.com |
| TaskId | string | no | The platform task ID |
| OrderUniqueId | string | no | The idempotent request ID specified by the business side |

### Creates an asynchronous recognition task for intelligent recognition scenarios by using the OSS URL of a…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentretailvision/recognize-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentretailvision.cn-beijing.aliyuncs.com |
| OrderUniqueId | string | no | The unique idempotent ID for the business party. The ID must be unique within the same business party |
| VideoUrls | string | no | The list of OSS URLs for shopping videos. Currently, only one URL is supported (JSON-encoded) |
| DeviceId | string | no | The device ID |
| CandidateItems | string | no | The list of candidate items. We recommend that you specify platform_item_id (JSON-encoded) |
| CallbackUrl | string | no | The callback URL for the current task. If this parameter is not specified, the registered default URL is used |

### Registers or updates the default webhook callback URL
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentretailvision/register-webhook` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentretailvision.cn-beijing.aliyuncs.com |
| CallbackUrl | string | no | The default callback URL. A public HTTPS URL is required |
| CallbackSecret | string | no | The key used for callback signature verification |

### Updates the information of an existing item on the platform
`POST https://zieapi.vercel.app/v1/cloud:aliyun-agentretailvision/update-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentretailvision.cn-beijing.aliyuncs.com |
| ItemUniqueId | string | no | The item ID of the business party. This ID is unique within the same business party |
| PlatformItemId | string | no | The platform item ID. This ID is globally unique |
| ImageTitle | string | no | The item title |
| MainImage | string | no | The list of main image URLs for the item. You must provide at least one image (JSON-encoded) |
| MultiViewImages | string | no | The list of multi-view images for the item (JSON-encoded) |
| ExtraImages | string | no | The list of additional image URLs that can be provided (JSON-encoded) |
| DeviceId | string | no | The device ID. This ID is used to establish a vector association between the device and the item |

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

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-agentretailvision/generate-group-image" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

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

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

### Can AI agents use the Alibaba Cloud AgentRetailVision 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-agentretailvision.

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