Sign in

v1

latestOpenAPI 3.1.02026-08-04118425322.0 KB
search > search

Hybrid Search

Search images using a text query that scores results against both visual content and text metadata (titles, captions, descriptions, and other text fields).This endpoint is in beta and requires special access, please contact the support team.

post/api/v1/search/text-to-hybrid-search

Headers

Authorizationstring required

Bearer authentication

Request body

dataset_idstring uuid required

The unique identifier for the dataset

text_querystring required

The text query to search for

negative_textstring nullable

Optional text describing what to exclude from search results. Steers the visual query embedding away from this direction.

limitinteger

Max number of items to return from hybrid search

skip_moderationboolean

Skip content moderation if enabled

moderation_score_type'probability' | 'level'

Score type returned by the moderation service.

  • PROBABILITY: Scores in range 0-1 (uses BGE Reranker model)
  • LEVEL: Scores in range 0-5 (uses OpenAI model)

Response

Successful Response