> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 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](/docs/de/overview/administration/workspaces/api-keys#ip-allowlisting).

**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:

```bash
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.

```bash
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`:

```python
from elevenlabs.client import ElevenLabs

elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)
```

Beispiel mit dem Node.js-Paket `elevenlabs`:

```javascript
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](/docs/de/api-reference/tokens/create).