v1

latestOpenAPI 3.1.02026-07-13154170539.0 KB
Voices
TTS Design

Design Voice Previews

Generates voice design previews from a text description.

post/v0/assistant/voice/design/preview

Request body

voice_descriptionstring nullable

Text prompt describing the desired voice characteristics (e.g., 'A deep, resonant male voice with a British accent, suitable for narration.'). If bio is provided, this field can be used to add more specific voice instructions. At least one of bio or voice_description should be provided.

biostring nullable

A biography or background of the character to generate a voice description from. Used with voice_description to generate a richer prompt for the TTS provider. At least one of bio or voice_description should be provided.

textstring nullable

Optional: Text to be spoken in the generated voice previews. If not provided, and auto_generate_text is false, ElevenLabs might use a default or generic text.

auto_generate_textboolean nullable

Optional: Whether to automatically generate a text suitable for the voice description if 'text' is not provided. Defaults to false by ElevenLabs.

model_id'eleven_multilingual_ttv_v2' | 'eleven_ttv_v3' nullable

Optional: Model to use for voice generation.

Response

Successful Response