identity

Search identities

Changed on

Search the team's identities (plus global identities) for matches against a media sample. Supports audio (voice matching) and image (face/visual matching); video is not yet supported for synchronous search.

post/identity/search

Request

  • Base URL: https://app.resemble.ai/api/v2
  • URL: https://app.resemble.ai/api/v2/identity/search
  • Auth: HTTP bearer

Request body

urlstring uri

URL to the media sample (one of url, file, signed_id is required)

signed_idstring

Signed ID from a secure upload

modality'audio' | 'image'

Inferred from the media's content type when omitted (defaults to audio)

top_kinteger

Response

Search results

successboolean
modality'audio' | 'image'
itemobject

Matches keyed by identity UUID. distance is a 0-100 match score (higher is closer; an identical sample scores 100). Image matches include score_type "cosine".

Changes

  • 8a47567fb818Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security BearerAuth was added to the API

  • 176f674c8590Revision changes
    • info

      api operation id search-identities removed and replaced with identity_searchIdentities