post https://api.twelvelabs.io/v1.2/search-v2
Use this endpoint to search for relevant matches in an index using text or various media queries.
Text queries:
- Use the
query_text
parameter to specify your query.
Media queries:
- Set the
query_media_type
parameter to the corresponding media type (example:image
). - Specify either one of the following parameters:
query_media_url
: Publicly accessible URL of your media file.query_media_file
: Local media file.
If bothquery_media_url
andquery_media_file
are specified in the same request,query_media_url
takes precedence.
Before using a media file as a query, ensure that the file meets the prerequisites.
NOTE: This endpoint is rate-limited. For details, see the Rate limits page.