elevenlabslib 0.7.0

Complete python wrapper for the elevenlabs API

elevenlabslib

Python wrapper for the full elevenlabs API.

Documentation now available at https://elevenlabslib.readthedocs.io/en/latest/

Installation

Just run pip install elevenlabslib, it's on pypi.

Note: On Linux, you may need to install portaudio. On debian and derivatives, it's sudo apt-get install libportaudio2, and possibly also sudo apt-get install python3-pyaudio.

IMPORTANT: The library requires libsndfile v1.1.0 or newer, as that is when mp3 support was introduced. This won't be an issue on Windows, but may be relevant on other platforms. Check the soundfile repo for more information.

Usage

For a far more comprehensive example, check example.py or the docs.

Here is a very simple usage sample.

• Retrieves a voice based on the name
• Plays back (using the included playback functions that use sounddevice) all its samples (and the preview)
• Generates and plays back a new audio
• Deletes the newly created audio from the user history

from elevenlabslib import *

user = ElevenLabsUser("API_KEY")
voice = user.get_voices_by_name("Rachel")[0]  # This is a list because multiple voices can have the same name

voice.play_preview(playInBackground=False)

voice.generate_and_play_audio("Test.", playInBackground=False)

for historyItem in user.get_history_items():
    if historyItem.text == "Test.":
        # The first items are the newest, so we can stop as soon as we find one.
        historyItem.delete()
        break