API Reference

Python Library

Community

ElevenLabs

Sign Up

Text to Speech

Help Center

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

Body_Download_history_items_v1_history_download_post

HTTPValidationError

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

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

Payouts

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

Audio Native in React

How to set up an ElevenLabs audio player for your articles in React (Next.js, Vite)

Audio Native in Ghost

How to set up an ElevenLabs audio player for your articles in Ghost

Audio Native in Squarespace

How to set up an ElevenLabs audio player for your articles in Squarespace

Audio Native in Framer

How to set up an ElevenLabs audio player for your articles in Framer

Audio Native in Webflow

How to set up an ElevenLabs audio player for your articles in Webflow

Audio Native in Wordpress

How to set up an ElevenLabs audio player for your articles in Wordpress

Audio Native in Wix

How to set up an ElevenLabs audio player for your articles in Wix

Audio Native in Substack

How to add an ElevenLabs voiceover to your articles in Substack

Dubbing made easy: reach a broader audience with ElevenLabs.

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

Studio

Get the most out of our Sound Effects Generator tool and learn how to create everything from blockbuster sound design for films to everyday sounds for your video game.

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 use the text to sound effects API to generate sound effects from text.

How to use the text to sound effects API

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

How to convert text to speech via websocket and save to mp3

How to use websocket

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

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 audio together with timestamps on when which word was spoken.

Text To Speech With Timestamps

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

Streaming

Converts text into audio together with timestamps on when which word was spoken in a streaming way.

Text To Speech Streaming With Timestamps

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.

API that converts text into sounds & uses the most advanced AI audio model ever. Create sound effects for your videos, voice-overs or video games.

Sound Generation

Audio Isolation

Removes background noise from audio and streams the result

Audio Isolation 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

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

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

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

Sends an email invitation to join your workspace to the provided email. If the user doesn't have an account they will be prompted to create one. If the user accepts this invite they will be added as a user to your workspace and your subscription using one of your seats. This endpoint may only be called by workspace administrators.

Invite User

Invalidates an existing email invitation. The invitation will still show up in the inbox it has been delivered to, but activating it to join the workspace won't work. This endpoint may only be called by workspace administrators.

Delete Existing Invitation

Updates attributes of a workspace member. Apart from the email identifier, all parameters will remain unchanged unless specified. This endpoint may only be called by workspace administrators.

Update Member

Returns the characters usage metrics for the current user or the entire workspace they are part of. The response will return a time axis with unix timestamps for each day and daily usage along that axis. The usage will be broken down by the specified breakdown type. For example, breakdown type "voice" will return the usage of each voice along the time axis.

Guides

Text to Speech

Speech to Speech

Sound Effects

Audio Isolation

History

Samples

User

Voices

Voice Generation

Voice Library

Projects

Pronunciation Dictionaries

Models

Audio-native

Dubbing

Workspace

Usage

Download History Items

Headers

Body