Sign in
latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Voices

List available voices

Returns all available AI voices for video narration, sorted by popularity. Use the voice id as the voiceId parameter when generating a video.

No authentication required. This is a public endpoint.

Multilingual support: All voices are multilingual and work across any language. Set the language parameter when generating a video and the voice will speak naturally in that language. The optimizedFor field lists languages where the voice has been specifically fine-tuned for best pronunciation and natural delivery.

Filtering: Use query parameters to narrow down voices by gender, accent, age, or use case. Combine multiple filters to find the perfect voice.

For full details and interactive testing, refer to the API documentation.

get/voices

Query parameters

genderstring

Filter by voice gender. Values: "male", "female", "neutral".

accentstring

Filter by accent (case-insensitive). Examples: "American", "British", "Australian", "Indian".

agestring

Filter by age group. Values: "young", "middle_aged", "old".

useCasestring

Filter by recommended use case (case-insensitive). Examples: "narration", "conversational", "news", "audiobook", "social_media".

languagestring

Filter to voices optimized for a specific language (ISO 639-1 code). Examples: "en", "es", "fr", "hi", "zh".

searchstring

Search voices by name or description (case-insensitive). Examples: "roger", "energetic", "calm".

Response

OK

idstring required

Unique voice identifier. Pass this as the voiceId parameter when generating a video.

namestring required

Voice name (e.g. "Roger", "Sarah", "James").

descriptionstring required

Voice characteristics and style (e.g. "Laid-Back, Casual, Resonant").

previewUrlstring uri required

Audio preview URL (MP3). Play this to hear how the voice sounds before selecting it.

genderstring nullable required

Voice gender (e.g. "male", "female", "neutral").

agestring nullable required

Approximate age group (e.g. "young", "middle_aged", "old").

accentstring nullable required

Primary accent (e.g. "American", "British", "Australian", "Indian"). Not all voices have an accent label.

useCasestring nullable required

Recommended use case (e.g. "narration", "conversational", "news", "audiobook", "social_media"). This is a suggestion; any voice works for any use case.

optimizedForstring[] required

ISO 639-1 language codes where this voice has been specifically fine-tuned for best pronunciation and natural delivery (e.g. ["en", "fr", "es"]).