Multimodal search (image / audio query)

POST 
/api/v1/search/multimodal

Same as /v1/search but the query is an uploaded image or audio file instead of text — useful when text is a poor description of what you're looking for. Multimodal embeddings on the query side; results come back in the omni column only.

Multipart form fields:

• file — the image or audio file (required)
• modality — image (default) or audio
• k — videos returned (default 20)
• scene_pool — candidate scenes pulled before grouping (default 60)

Request

Responses

200

Successful Response

401

Missing or invalid API key. Add Authorization: Bearer vuf_live_<keyid>.<secret>.

403

Key used outside the public API roots (/api/v1, /api/v1.1).

422

Request body failed validation.

500

Upstream service error — usually safe to retry.