MOmoda
voices

Find Similar Voices

Changed on

Find ElevenLabs Voice Library voices that sound like an uploaded recording, closest first.

source_audio is a file_ id from POST /v1/uploads (mp3, wav or aac, 1-300 seconds); it is streamed to the provider and no copy is kept. Each result is the same voice object as GET /v1/voices/{voice_id}: speak it by its vox_ id like any catalog voice. These voices never appear in GET /v1/voices. Free (model_not_in_plan, required_plan: starter) is refused; the search itself is not charged.

post/voices/similar

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/voices/similar
  • Auth
    HTTP bearer

Headers

X-Voice-Enginesstring nullable

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'2026-04-12' | '2026-05-01'
Example: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.

Request body

source_audiostring required

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

limitinteger

How many voices to return, closest first.

Response

Successful Response

object'list'
returnedinteger required

Changes