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.

Image
17.46 credits/call

Pricing

17.46 credits/call
ConditionCharge
Each call17.46 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectNo图像输入以及预期的1688图像搜索目标—
request_body.urlstringNo图像 URL。请提供 url 或 imgBase64 之一。—
request_body.imgBase64stringNo以 Base64 编码的 JPEG 图像,不包含 data URI 前缀;解码后大小不得超过 100 KB。—
request_body.searchApiEndpointenum (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-Key
Request 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
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": {}
  }
}