API-Authentifizierung

API-Schlüssel

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 Ihr Nutzungskontingent zu erfassen.

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

1. Bereichseinschrä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 zur Steuerung der Nutzung.
3. IP-Zulassungsliste: Beschränken Sie den Schlüssel auf bestimmte IP-Adressen oder CIDR-Bereiche. Anfragen von nicht zugelassenen IPs werden mit einem 403-Fehler abgelehnt. Mehr erfahren.

Denken Sie daran, dass Ihr API-Schlüssel geheim ist. Teilen Sie ihn nicht mit anderen und legen Sie ihn nicht in clientseitigem Code offen (Browser, Apps).

Alle API-Anfragen sollten Ihren API-Schlüssel wie folgt im HTTP-Header xi-api-key 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-Tokens

Für bestimmte Endpunkte können Sie Einmal-Tokens zur Authentifizierung Ihrer Anfragen verwenden. Diese Tokens sind nur begrenzt gültig und ermöglichen eine Verbindung zur API, ohne Ihren API-Schlüssel offenzulegen, etwa clientseitig.

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