API tìm kiếm sản phẩm bằng ảnh
POST /v1/products/search-by-image — tìm sản phẩm tương tự bằng ảnh trên 1688 và Taobao.
Truyền image_id từ upload image, hoặc cung cấp image_base64 / image_url để upload + search trong một cuộc gọi.
Request body
| Field | Required | Description |
|---|---|---|
channel | Yes | 1688 | taobao |
image_id | One of | Từ upload-image |
image_base64 / image_url | One of | Upload + search trong một bước |
image_address | 1688 | URL ảnh alicdn/1688 hiện có |
region | No | Khung crop, ví dụ 266,799,48,581 |
keyword | No | Tinh chỉnh trong kết quả ảnh |
page / page_size | No | Phân trang |
language | No | Mặc định en |
Ví dụ
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}Response
Giống keyword search — StandardProductList, kèm pic_region_info tùy chọn (vùng chủ thể được phát hiện).
Luồng khuyến nghị {#image-search-flow}
Tùy chọn A — hai bước (tái sử dụng image_id):
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...Tùy chọn B — một bước:
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }