Zur Navigation springen
Tutorials

ElevenAPI-Schnellstart

Erfahren Sie, wie Sie Ihre erste ElevenLabs-API-Anfrage stellen.

Am Ende dieses Leitfadens haben Sie ElevenLabs in Ihrem Projekt eingerichtet und können Ihre erste Text to Speech-Anfrage stellen. Dafür gibt es zwei Möglichkeiten: Lassen Sie Ihren Coding-Agent die Einrichtung übernehmen oder erledigen Sie sie manuell.

Anleitungen zu weiteren Funktionen – Streaming, KI-Stimme klonen, Speech to Text – finden Sie im Bereich Tutorials.

Einrichtung mit Ihrem Coding-Agent

Sie benötigen vor dem Start weder ein Konto noch einen API-Schlüssel. Fügen Sie dies in Ihren Coding-Agent ein:

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

Die ElevenLabs CLI übernimmt den Rest und erklärt Ihrem Agenten jeden Schritt. Ihr Browser öffnet sich einmal, damit Sie sich anmelden oder ein Konto erstellen und auf Autorisieren klicken können. Der Schlüssel wird in der Umgebungsdatei Ihres Projekts gespeichert (.env.local oder .env bei einem Python-Projekt) und von Git ferngehalten; er wird niemals im Chat angezeigt. Der Agent fragt Sie dann, was Sie erstellen möchten, installiert das SDK, fügt den Code Ihrer App hinzu und fragt, ob eine Testanfrage gesendet werden soll.

Wenn Ihr Agent an einem Ort läuft, den Ihr Browser nicht erreichen kann, etwa auf einem Remote-Rechner über SSH oder in einer Cloud-Sandbox, fordert die CLI Sie auf, selbst einen Schlüssel zu erstellen und ihn in die Umgebungsdatei einzufügen. Anschließend fährt sie fort. Der Befehl benötigt Node.js für npx. Falls es nicht installiert ist, installieren Sie die ElevenLabs CLI mit Homebrew (macOS und Linux) oder Scoop (Windows), oder aktualisieren Sie sie, falls sie bereits installiert ist (brew upgrade elevenlabs, scoop update elevenlabs), und bitten Sie Ihren Agenten stattdessen, elevenlabs onboard init auszuführen.

Manuelle Einrichtung

1

API-Schlüssel erstellen

Erstellen Sie hier im Dashboard einen API-Schlüssel, den Sie verwenden, um sicher auf die API zuzugreifen.

Speichern Sie den Schlüssel als verwaltetes Secret und übergeben Sie ihn den SDKs je nach Präferenz entweder als Umgebungsvariable über eine .env-Datei oder direkt in der Konfiguration Ihrer App.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

SDK installieren

Wir verwenden außerdem die Bibliothek dotenv, um unseren API-Schlüssel aus einer Umgebungsvariable zu laden.

pip install elevenlabs
pip install python-dotenv

Um die Audioausgabe über Ihre Lautsprecher abzuspielen, werden Sie möglicherweise aufgefordert, MPV und/oder ffmpeg zu installieren.

3

Ihre erste Anfrage stellen

Erstellen Sie je nach bevorzugter Sprache eine neue Datei mit dem Namen example.py oder example.mts und fügen Sie den folgenden Code hinzu:

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
    text="The first move is what sets everything in motion.",
    voice_id="JBFqnCBsd6RMkjVDRZzb",  # "George" - browse voices at elevenlabs.io/app/voice-library
    model_id="eleven_v4",
    output_format="mp3_44100_128",
)
play(audio)

Führen Sie ihn dann aus:

python example.py

Die Audioausgabe sollte über Ihre Lautsprecher wiedergegeben werden.

Nächste Schritte

Audio streamen

Reduzieren Sie die Latenz, indem Sie Audio während der Generierung streamen, statt auf die vollständige Datei zu warten

Stimmen durchsuchen

Entdecken Sie über 10.000 Stimmen und ersetzen Sie die Beispiel-Stimm-ID durch eine, die zu Ihrem Anwendungsfall passt

Eine Stimme klonen

Erstellen Sie aus einer kurzen Audioaufnahme eine individuelle Stimme