Skip to main content
POST
Find Similar Voices

Authorizations

Authorization
string
header
required

API key from Settings > Developer > REST API

Headers

X-Voice-Engines
string | null

The voice engines this client understands, comma-separated: elevenlabs,fishaudio,inworld. ElevenLabs is always on; Fish Audio models and voices appear only for a client that lists fishaudio (or, on GET /v1/voices, asks for provider=fishaudio or a featured/community category), and Inworld's only for a client that lists inworld (or asks for provider=inworld).

Moda-Version
enum<string>
default:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Available options:
2026-04-12,
2026-05-01
Example:

"2026-05-01"

Body

application/json

POST /v1/voices/similar body (section 3.11).

source_audio
string
required

The file_ id of an uploaded recording (POST /v1/uploads): mp3, wav or aac, 1-300 s.

Required string length: 1 - 64
limit
integer
default:5

How many voices to return, closest first.

Required range: 1 <= x <= 10

Response

Successful Response

POST /v1/voices/similar: the matched voices, closest first, in their detail form.

data
VoiceDetail · object[]
required
returned
integer
required
object
string
default:list
Allowed value: "list"