# elevenlabs > No description - **URL**: https://www.freshcrate.ai/projects/elevenlabs - **Author**: pypi - **Category**: Developer Tools - **Latest version**: `v2.51.0` (2026-06-02) - **License**: MIT - **Source**: https://github.com/elevenlabs/elevenlabs-python - **Homepage**: https://pypi.org/project/elevenlabs/ - **Language**: Python - **GitHub**: 2,935 stars, 409 forks - **Registry**: pypi (`elevenlabs`) - **Tags**: `pypi` ## Description # ElevenLabs Python Library ![LOGO](https://github.com/elevenlabs/elevenlabs-python/assets/12028621/21267d89-5e82-4e7e-9c81-caf30b237683) [![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-SDK%20generated%20by%20Fern-brightgreen)](https://buildwithfern.com/?utm_source=fern-elevenlabs/elevenlabs-python/readme) [![Discord](https://badgen.net/badge/black/ElevenLabs/icon?icon=discord&label)](https://discord.gg/elevenlabs) [![Twitter](https://badgen.net/badge/black/elevenlabsio/icon?icon=twitter&label)](https://twitter.com/elevenlabsio) [![PyPI - Python Version](https://img.shields.io/pypi/v/elevenlabs?style=flat&colorA=black&colorB=black)](https://pypi.org/project/elevenlabs/) [![Downloads](https://static.pepy.tech/personalized-badge/elevenlabs?period=total&units=international_system&left_color=black&right_color=black&left_text=Downloads)](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) ```
Play 🎧 **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.
## 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. ## 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 ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `v2.51.0` | 2026-06-02 | High | ## What's Changed * SDK regeneration by @fern-api[bot] in https://github.com/elevenlabs/elevenlabs-python/pull/799 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.50.0...v2.51.0 | | `v2.50.0` | 2026-05-26 | High | ## What's Changed * SDK regeneration by @fern-api[bot] in https://github.com/elevenlabs/elevenlabs-python/pull/794 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.49.1...v2.50.0 | | `v2.49.1` | 2026-05-21 | High | ## What's Changed * [Speech Engine] Add full response to Speech Engine API calls by @PaulAsjes in https://github.com/elevenlabs/elevenlabs-python/pull/793 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.49.0...v2.49.1 | | `v2.48.0` | 2026-05-18 | High | ## What's Changed * fix: add speech_engine_custom.py to .fernignore by @kraenhansen in https://github.com/elevenlabs/elevenlabs-python/pull/789 * :herb: Fern Regeneration -- May 18, 2026 by @fern-api[bot] in https://github.com/elevenlabs/elevenlabs-python/pull/790 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.47.0...v2.48.0 | | `v2.47.0` | 2026-05-12 | High | ## What's Changed * :herb: Fern Regeneration -- May 12, 2026 by @fern-api[bot] in https://github.com/elevenlabs/elevenlabs-python/pull/785 * Speech Engine SDK by @PaulAsjes in https://github.com/elevenlabs/elevenlabs-python/pull/771 * Fix test in CI by @PaulAsjes in https://github.com/elevenlabs/elevenlabs-python/pull/786 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.46.0...v2.47.0 | | `v2.46.0` | 2026-05-07 | High | ## What's Changed * refactor: use urllib.parse for WebSocket URL construction by @kraenhansen in https://github.com/elevenlabs/elevenlabs-python/pull/780 * Add keyterms and no_verbatim to Scribe realtime API by @kraenhansen in https://github.com/elevenlabs/elevenlabs-python/pull/778 * fix: add url_utils.py to .fernignore by @kraenhansen in https://github.com/elevenlabs/elevenlabs-python/pull/782 * :herb: Fern Regeneration -- May 7, 2026 by @fern-api[bot] in https://github.com/elevenlabs/elevenla | | `v2.45.0` | 2026-04-27 | High | ## What's Changed * fix: correct notebook install hint by @Ankit-Kotnala in https://github.com/elevenlabs/elevenlabs-python/pull/776 * :herb: Fern Regeneration -- April 27, 2026 by @fern-api[bot] in https://github.com/elevenlabs/elevenlabs-python/pull/777 ## New Contributors * @Ankit-Kotnala made their first contribution in https://github.com/elevenlabs/elevenlabs-python/pull/776 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.44.0...v2.45.0 | | `2.44.0` | 2026-04-21 | Low | Imported from PyPI (2.44.0) | | `v2.44.0` | 2026-04-21 | High | ## What's Changed * :herb: Fern Regeneration -- April 21, 2026 by @fern-api[bot] in https://github.com/elevenlabs/elevenlabs-python/pull/775 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.43.0...v2.44.0 | | `v2.44.0` | 2026-04-21 | High | ## What's Changed * :herb: Fern Regeneration -- April 21, 2026 by @fern-api[bot] in https://github.com/elevenlabs/elevenlabs-python/pull/775 **Full Changelog**: https://github.com/elevenlabs/elevenlabs-python/compare/v2.43.0...v2.44.0 | ## Citation - HTML: https://www.freshcrate.ai/projects/elevenlabs - Markdown: https://www.freshcrate.ai/projects/elevenlabs.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/elevenlabs/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._