1688 Convert Image
17.46 credits/call
ae_ali1688_convert_image
Prepare an image for visual product search by converting an image URL or Base64-encoded JPEG into an image reference for the selected search target. In request_body, provide either url or imgBase64. Base64 input must omit the data URI prefix, and the decoded JPEG must not exceed 100 KB. Set searchApiEndpoint to standard (default), cross_border_v1, or cross_border_v2 to match the intended search target. The response contains status information and conversion data; successful conversion provides an image reference, not product matches. The detailed structure of the conversion data is not specified.
17.46 credits/call
Pricing
17.46 credits/call
| Condition | Charge |
|---|---|
| Each call | 17.46 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | No | 图像输入以及预期的1688图像搜索目标 | — |
request_body.url | string | No | 图像 URL。请提供 url 或 imgBase64 之一。 | — |
request_body.imgBase64 | string | No | 以 Base64 编码的 JPEG 图像,不包含 data URI 前缀;解码后大小不得超过 100 KB。 | — |
request_body.searchApiEndpoint | enum (standard | cross_border_v1 | cross_border_v2) | No | 转换后引用的图像搜索目标。 | standard |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_ali1688_convert_image' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"searchApiEndpoint": "cross_border_v1",
"url": "https://ir-21.ozonstatic.cn/s3/multimedia-1-p/wc500/9428245837.jpg"
}
}
}'Response exampleresponse.json
{
"code": 0,
"data": {
"image_url": "/search/imgextra5/1349908887887800968.jpg"
},
"message": null,
"recordTime": "2026-11-16T00:46:27.431999156",
"requestParams": {
"body": {
"searchApiEndpoint": "cross_border_v1",
"url": "https://ir-21.ozonstatic.cn/s3/multimedia-1-p/wc500/9428245837.jpg"
},
"query": {}
}
}
