Find it from a photograph
visual_searchRead-onlyIdempotent
Pieces on the boutiques' shelves that resemble a photograph: a screenshot, a street style shot, a product photo, or a TikTok or Pinterest link. Answers in two tiers: pieces close enough to be the same or a near twin, and pieces in the same spirit. Use this when a shopper shares an image of something they want to find or 'something like this'. Pass image_url for a direct image, image_base64 with media_type for an uploaded file, or post_url for a TikTok or Pinterest link. Photographs are matched in memory and never stored. Do not use for Instagram links; they cannot be read, so ask for a screenshot instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| post_url | No | A TikTok or Pinterest post link; the photograph is read from the post. | |
| image_url | No | A direct, publicly reachable JPEG, PNG or WebP URL (under 1.5 MB). | |
| image_file | No | A photograph the shopper uploaded in the chat; the host passes the file here. | |
| media_type | No | Required with image_base64. | |
| image_base64 | No | The image bytes, base64 encoded (under 1.5 MB decoded). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| close | Yes | ||
| in_spirit | Yes |