douyin/search/vision-search
Douyin APP vision search (image-based search / reverse image search).. Search for similar videos/images using an image.
Input
Original video ID, only used when search_source="visual_normal_search"
Pagination cursor (0 for the first page)
Detection area coordinates, format "x1,y1,x2,y2"
Detection index, default 0
Image URI obtained from other Douyin API responses (e.g., video details, search results, user profile) (required)
Search ID (empty for first request, obtained from previous response for pagination)
Search source
Search keyword, only used when search_source="visual_normal_search"
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
douyin/search/vision-search01
Input Schema
8 parameters · 1 required · 7 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image_uri | string | Required | Image URI obtained from other Douyin API responses (e.g., video details, search results, user profile) (required) |
cursor | integer | Optional | Pagination cursor (0 for the first page) |
aweme_id | string | Optional | Original video ID, only used when search_source="visual_normal_search" |
detection | string | Optional | Detection area coordinates, format "x1,y1,x2,y2" |
search_id | string | Optional | Search ID (empty for first request, obtained from previous response for pagination) |
user_query | string | Optional | Search keyword, only used when search_source="visual_normal_search" |
search_source | string | Optional | Search source |
detection_index | integer | Optional | Detection index, default 0 |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "douyin/search/vision-search",
"prompt": "a beautiful sunset over mountains"
}'API README
Fetch vision search (image-based search)
Douyin APP vision search (image-based search / reverse image search). Search for similar videos/images using an image. It is suitable for douyin workflows.
Capability
Douyin APP vision search (image-based search / reverse image search). Search for similar videos/images using an image. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Search and discover relevant records for research, monitoring, and product experiences.
- Build media monitoring, content intelligence, and publishing-support workflows.
- Create repeatable integrations that pass structured results to downstream business systems.