Generate a random voice based on parameters. This method returns a generated_voice_id in the response header, and a sample of the voice in the body. If you like the generated voice call /v1/voice-generation/create-voice with the generated_voice_id to create the voice.

Generate A Random Voice

Location

Message

Error Type

ValidationError

Body_Generate_a_random_voice_v1_voice_generation_generate_voice_post

HTTPValidationError

ElevenLabs

Explore our Guides and API Reference to get the most out of ElevenLabs.

Introduction

Discover all the voices ElevenLabs has to offer

Overview

A curated set of voices for our core use cases.

Premade Voices

A guide on how to generate voiceovers using your voice on ElevenLabs.

Choose voices for text-to-speech and speech-to-speech

Voice Selection

A guide on using stability, similarity sliders for tailored voice performances in ElevenLabs. Learn how to strike a balance between emotive and consistent audio outputs.

Voice Settings

Models

A guide on using our voice conversion tool for the most natural-sounding speech

Speech-to-Speech

Effective techniques to guide ElevenLabs AI in adding pauses, conveying emotions, and pacing the speech.

Prompting

Help us refine our models by providing feedback.

Feedback

Dubbing made easy: reach a broader audience with ElevenLabs.

The ultimate end-to-end workflow for creating amazing dubs.

Studio

An overview on how teams can collaborate in a shared workspace.

Elevate your projects with this guide into the Voiceover Studio.

Important considerations for ElevenLabs' beta voice generation, including text length, model choice, voice types, and generation settings, with tips for optimizing audio quality.

Start generating your first text-to-speech using Python and ElevenLabs API

Getting Started

How to convert text into speech, upload to S3, and share with a signed URL

How to use text to speech

How to use text to speech with streaming in Python or Node.js

Learn how to keep your voice stable across multiple generations

Combining multiple generations

How to add, view, and remove rules to pronunciation dictionaries with the Python SDK

How to use pronunciation dictionaries

How to use pronunciation dictionaries (Python SDK)

Learn how to automate the dubbing of audio and video files into various languages using the ElevenLabs API

How to dub a video

How to dub video and audio with ElevenLabs

Integrating with Twilio

How to send an AI message through a phone call using Twilio and ElevenLabs in Node.js

Seven methods for reducing streaming latency, in order of highest to lowest effectiveness:

Reducing Latency

API that converts text into lifelike speech with best-in-class latency & uses the most advanced AI audio model ever. Create voiceovers for your videos, audiobooks, or create AI chatbots for free.

Text To Speech

Converts text into speech using a voice of your choice and returns audio as an audio stream.

Streaming

Websockets

Use Speech to Speech API to transform uploaded speech so it sounds like it was spoken by another voice. STS gives you full control over the emotions, timing and delivery.

Speech To Speech

Create speech by combining the content and emotion of the uploaded audio with a voice of your choice and returns an audio stream.

Returns metadata about all your generated audio.

Get Generated Items

Returns information about an history item by its ID.

Get History Item By Id

Delete History Item

Get Audio From History Item

Download one or more history items. If one history item ID is provided, we will return a single audio file. If more than one history item IDs are provided, we will provide the history items packed into a .zip file.

Download History Items

Delete Sample

Returns the audio corresponding to a sample attached to a voice.

Get Audio From Sample

Gets extended information about the users subscription

Get User Subscription Info

Get User Info

Gets a list of all available voices for a user.

Get Voices

Gets the default settings for voices. "similarity_boost" corresponds to"Clarity + Similarity Enhancement" in the web app and "stability" corresponds to "Stability" slider in the web app.

Get Default Voice Settings.

Returns the settings for a specific voice. "similarity_boost" corresponds to"Clarity + Similarity Enhancement" in the web app and "stability" corresponds to "Stability" slider in the web app.

Get Voice Settings

Get Voice

Delete Voice

Edit your settings for a specific voice. "similarity_boost" corresponds to"Clarity + Similarity Enhancement" in the web app and "stability" corresponds to "Stability" slider in the web app.

Edit Voice Settings

Add a new voice to your collection of voices in VoiceLab.

Add Voice

Edit Voice

Get possible parameters for the /v1/voice-generation/generate-voice endpoint.

Voice Generation Parameters

Add a sharing voice to your collection of voices in VoiceLab.

Add Sharing Voice

Returns a list of your projects together and its metadata.

Get Projects

Returns information about a specific project. This endpoint returns more detailed information about a project than GET api.elevenlabs.io/v1/projects.

Get Project By Id

Creates a new project, it can be either initialized as blank, from a document or from a URL.

Add Project

Delete Project

Starts conversion of a project and all of its chapters.

Convert Project

Get Project Snapshots

Stream the audio from a project snapshot.

Stream Project Audio

Returns a list of your chapters for a project together and its metadata.

Get Chapters

Returns information about a specific chapter.

Get Chapter By Id

Delete Chapter

Convert Chapter

Gets information about all the snapshots of a chapter, each snapshot corresponds can be downloaded as audio. Whenever a chapter is converted a snapshot will be automatically created.

Get Chapter Snapshots

Stream the audio from a chapter snapshot. Use `GET /v1/projects/{project_id}/chapters/{chapter_id}/snapshots` to return the chapter snapshots of a chapter.

Stream Chapter Audio

Updates the set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does.

Update Pronunciation Dictionaries

Creates a new pronunciation dictionary from a lexicon .PLS file

Add from file

Get a list of the pronunciation dictionaries you have access to and their metadata

Get dictionaries

Get metadata for a pronunciation dictionary

Get dictionary by id

Add rules to the pronunciation dictionary

Add rules

Remove rules from the pronunciation dictionary

Remove rules

Get PLS file with a pronunciation dictionary version rules

Download version by id

Get Models

Creates AudioNative enabled project, optionally starts conversion and returns project id and embeddable html snippet.

Creates Audionative Enabled Project.

Dubs provided audio or video file into given language.

Dub A Video Or An Audio File

Returns metadata about a dubbing project, including whether it's still in progress or not

Get Dubbing Project Metadata

Returns dubbed file as a streamed file. Videos will be returned in MP4 format and audio only dubs will be returned in MP3.

Get Dubbed File

Delete Dubbing Project

API Reference

Python Library

Community

Sign Up

Text to Speech

Help Center

Discover ElevenLabs' Voice Design tool to create original, custom voices by selecting gender, age, and accent. Experience the same quality as premade voices, but tailor-made to your preferences.

Voice Design

Guide for getting the most out of you cloned voices.

Instant Voice Cloning

Guide to getting the highest quality voice clone available.

Professional Voice Cloning

Discover AI voices from the ElevenLabs community

Learn how to share voices in the Voice Library.

Sharing Voices

Earn rewards for sharing voices in the Voice Library

Guides

Text to Speech

Speech to Speech

History

Samples

User

Voices

Voice Generation

Voice Library

Projects

Pronunciation Dictionaries

Models

Audio-native

Dubbing

Generate A Random Voice

Headers

Body

Response