Description

# ElevenLabs Python Library  [](https://buildwithfern.com/?utm_source=fern-elevenlabs/elevenlabs-python/readme) [](https://discord.gg/elevenlabs) [](https://twitter.com/elevenlabsio) [](https://pypi.org/project/elevenlabs/) [](https://pepy.tech/project/elevenlabs) The official Python SDK for [ElevenLabs](https://elevenlabs.io/). ElevenLabs brings the most compelling, rich and lifelike voices to creators and developers in just a few lines of code. ## 📖 API & Docs Check out the [HTTP API documentation](https://elevenlabs.io/docs/api-reference). ## Install ```bash pip install elevenlabs ``` ## Usage ### Main Models 1. **Eleven v3** (`eleven_v3`) - Dramatic delivery and performances - 70+ languages supported - Supported for natural multi-speaker dialogue 2. **Eleven Multilingual v2** (`eleven_multilingual_v2`) - Excels in stability, language diversity, and accent accuracy - Supports 29 languages - Recommended for most use cases 3. **Eleven Flash v2.5** (`eleven_flash_v2_5`) - Ultra-low latency - Supports 32 languages - Faster model, 50% lower price per character 4. **Eleven Turbo v2.5** (`eleven_turbo_v2_5`) - Good balance of quality and latency - Ideal for developer use cases where speed is crucial - Supports 32 languages For more detailed information about these models and others, visit the [ElevenLabs Models documentation](https://elevenlabs.io/docs/models). ```py from dotenv import load_dotenv from elevenlabs.client import ElevenLabs from elevenlabs.play import play load_dotenv() elevenlabs = ElevenLabs() audio = elevenlabs.text_to_speech.convert( text="The first move is what sets everything in motion.", voice_id="JBFqnCBsd6RMkjVDRZzb", model_id="eleven_v3", output_format="mp3_44100_128", ) play(audio) ``` <details> <summary> Play </summary> 🎧 **Try it out!** Want to hear our voices in action? Visit the [ElevenLabs Voice Lab](https://elevenlabs.io/voice-lab) to experiment with different voices, languages, and settings. </details> ## Voices List all your available voices with `search()`. ```py from elevenlabs.client import ElevenLabs elevenlabs = ElevenLabs( api_key="YOUR_API_KEY", ) response = elevenlabs.voices.search() print(response.voices) ``` For information about the structure of the voices output, please refer to the [official ElevenLabs API documentation for Get Voices](https://elevenlabs.io/docs/api-reference/get-voices). Build a voice object with custom settings to personalize the voice style, or call `elevenlabs.voices.settings.get("your-voice-id")` to get the default settings for the voice. </details> ## Clone Voice Clone your voice in an instant. Note that voice cloning requires an API key, see below. ```py from elevenlabs.client import ElevenLabs from elevenlabs.play import play elevenlabs = ElevenLabs( api_key="YOUR_API_KEY", ) voice = elevenlabs.voices.ivc.create( name="Alex", description="An old American male voice with a slight hoarseness in his throat. Perfect for news", # Optional files=["./sample_0.mp3", "./sample_1.mp3", "./sample_2.mp3"], ) ``` ## Streaming Stream audio in real-time, as it's being generated. ```py from elevenlabs import stream from elevenlabs.client import ElevenLabs elevenlabs = ElevenLabs( api_key="YOUR_API_KEY", ) audio_stream = elevenlabs.text_to_speech.stream( text="This is a test", voice_id="JBFqnCBsd6RMkjVDRZzb", model_id="eleven_multilingual_v2" ) # option 1: play the streamed audio locally stream(audio_stream) # option 2: process the audio bytes manually for chunk in audio_stream: if isinstance(chunk, bytes): print(chunk) ``` ## Async Client Use `AsyncElevenLabs` if you want to make API calls asynchronously. ```python import asyncio from elevenlabs.client import AsyncElevenLabs elevenlabs = AsyncElevenLabs( api_key="MY_API_KEY" ) async def print_models() -> None: models = await elevenlabs.models.list() print(models) asyncio.run(print_models()) ``` ## ElevenAgents Build interactive AI agents with real-time audio capabilities using ElevenAgents. ### Basic Usage ```python from elevenlabs.client import ElevenLabs from elevenlabs.conversational_ai.conversation import Conversation, ClientTools from elevenlabs.conversational_ai.default_audio_interface import DefaultAudioInterface