API de recherche produit par image
POST /v1/products/search-by-image — trouve des produits similaires par image sur 1688 et Taobao.
Passez image_id depuis téléverser une image, ou fournissez image_base64 / image_url pour téléverser + rechercher en un seul appel.
Corps de requête
| Champ | Obligatoire | Description |
|---|---|---|
channel | Oui | 1688 | taobao |
image_id | Un parmi | Depuis upload-image |
image_base64 / image_url | Un parmi | Téléversement + recherche en une étape |
image_address | 1688 | URL d’image alicdn/1688 existante |
region | Non | Zone de recadrage, par ex. 266,799,48,581 |
keyword | Non | Affiner dans les résultats par image |
page / page_size | Non | Pagination |
language | Non | Par défaut en |
Exemple
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}Réponse
Identique à la recherche par mot-clé — StandardProductList, plus pic_region_info optionnel (région du sujet détectée).
Flux recommandé {#image-search-flow}
Option A — deux étapes (réutiliser image_id) :
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...Option B — une étape :
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }