상품 이미지 검색 API
POST /v1/products/search-by-image — 이미지로 1688과 Taobao의 유사 상품을 찾습니다.
upload image에서 받은 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"
}응답
keyword search와 동일한 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": "..." }