Zur Navigation springen
API reference

API-Authentifizierung

Erfahren Sie, wie Sie Ihre ElevenLabs-API-Anfragen authentifizieren

API-Schlüssel

Überspringen Sie den Schlüssel. Lassen Sie ihn von Ihrem Coding-Agent einrichten.

Fügen Sie dies in Claude Code, Cursor oder Codex ein. Es meldet Sie an oder erstellt ein Konto, erstellt einen Schlüssel und fügt das SDK Ihrem Projekt hinzu.

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

So funktioniert es, oder lesen Sie den Quellcode des Befehls onboard, um genau zu sehen, was er Ihrem Agent mitteilt.

Die ElevenLabs API verwendet API-Schlüssel zur Authentifizierung. Jede Anfrage an die API muss Ihren API-Schlüssel enthalten, um Ihre Anfragen zu authentifizieren und das Nutzungskontingent nachzuverfolgen.

Jeder API-Schlüssel kann mit folgenden Einschränkungen konfiguriert werden:

  1. Bereichsbeschränkung: Legen Sie Zugriffsbeschränkungen fest, indem Sie begrenzen, auf welche API-Endpunkte der Schlüssel zugreifen kann.
  2. Credit-Kontingent: Definieren Sie individuelle Credit-Limits, um die Nutzung zu steuern.
  3. IP-Allowlisting: Beschränken Sie den Schlüssel auf bestimmte IP-Adressen oder CIDR-Bereiche. Anfragen von nicht allowgelisteten IPs werden mit einem 403-Fehler abgelehnt. Mehr erfahren.

Denken Sie daran, dass Ihr API-Schlüssel geheim ist. Geben Sie ihn nicht an andere weiter und legen Sie ihn nicht in clientseitigem Code offen (Browser, Apps).

Alle API-Anfragen sollten Ihren API-Schlüssel in einem HTTP-Header xi-api-key wie folgt enthalten:

xi-api-key: ELEVENLABS_API_KEY

Anfragen stellen

Sie können den folgenden Befehl in Ihr Terminal einfügen, um Ihre erste API-Anfrage auszuführen. Ersetzen Sie $ELEVENLABS_API_KEY durch Ihren geheimen API-Schlüssel.

curl 'https://api.elevenlabs.io/v1/models' \
  -H 'Content-Type: application/json' \
  -H 'xi-api-key: $ELEVENLABS_API_KEY'

Beispiel mit dem Python-Paket elevenlabs:

from elevenlabs.client import ElevenLabs
elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)

Beispiel mit dem Node.js-Paket elevenlabs:

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

Einmal-Token

Für bestimmte Endpunkte können Sie Einmal-Token verwenden, um Ihre Anfragen zu authentifizieren. Diese Token sind für begrenzte Zeit gültig und können verwendet werden, um eine Verbindung zur API herzustellen, ohne Ihren API-Schlüssel offenzulegen, etwa von der Client-Seite aus.

Weitere Informationen finden Sie in der Dokumentation zu Einmal-Token.