API de búsqueda de productos por imagen
POST /v1/products/search-by-image: encuentra productos similares por imagen en 1688 y Taobao.
Pasa image_id desde cargar imagen, o suministra image_base64 / image_url para cargar + buscar en una sola llamada.
Cuerpo de la solicitud
| Campo | Obligatorio | Descripción |
|---|---|---|
channel | Sí | 1688 | taobao |
image_id | Uno de | Desde upload-image |
image_base64 / image_url | Uno de | Cargar + buscar en un paso |
image_address | 1688 | URL de imagen alicdn/1688 existente |
region | No | Caja de recorte, por ejemplo 266,799,48,581 |
keyword | No | Refinar dentro de resultados por imagen |
page / page_size | No | Paginación |
language | No | Predeterminado en |
Ejemplo
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}Respuesta
Igual que búsqueda por palabra clave: StandardProductList, más pic_region_info opcional (región del sujeto detectada).
Flujo recomendado {#image-search-flow}
Opción A: dos pasos (reutilizar image_id):
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...Opción B: un paso:
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }