Sign in

v1

latestOpenAPI 3.1.02026-08-04118425322.0 KB
search > search

Image to Image Search

Find visually similar images using a reference image. Provide the reference as either a coactive_image_id (an asset already in the dataset) or a public_url.Useful for finding visually related assets.

post/api/v1/search/image-to-image

Headers

Authorizationstring required

Bearer authentication

Request body

dataset_idstring uuid required

The unique identifier for the dataset

offsetinteger

Starting index to return

limitinteger

Max number of items to return

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)
coactive_image_idstring uuid nullable

The image to search for represented with a CID

public_urlstring nullable

The image to search for represented with a public http url

upload_idstring nullable

The upload ID to search for

asset_type'image' | 'video'
skip_moderationboolean

Skip content moderation if enabled

Response

Successful Response