以图搜商品 API
POST /v1/products/search-by-image — 在 1688 与 淘宝 上按图片查找相似商品。
传入 上传图片 返回的 image_id，或提供 image_base64 / image_url 一步完成上传与搜索。
请求体
| 字段 | 必填 | 说明 |
|---|---|---|
channel | 是 | 1688 | taobao |
image_id | 三选一 | 来自 upload-image |
image_base64 / image_url | 三选一 | 一步上传并搜索 |
image_address | 1688 | 已有的 alicdn/1688 图片 URL |
region | 否 | 裁剪框，如 266,799,48,581 |
keyword | 否 | 在以图结果内进一步筛选 |
page / page_size | 否 | 分页 |
language | 否 | 默认 en |
示例
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}响应
与 关键词搜索 相同 — StandardProductList，另可选 pic_region_info（检测到的主体区域）。
推荐流程 {#image-search-flow}
方案 A — 两步（复用 image_id）：
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...方案 B — 一步：
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }