Skip to navigation
API reference

API-authenticatie

Leer hoe je je ElevenLabs API-requests authenticeert

API-sleutels

De ElevenLabs API gebruikt API-sleutels voor authenticatie. Elke request naar de API moet je API-sleutel bevatten, waarmee je requests worden geauthenticeerd en je gebruiksquotum wordt bijgehouden.

Je kunt elke API-sleutel met de volgende beperkingen configureren:

  1. Bereikbeperking: Stel toegangsbeperkingen in door te beperken tot welke API-endpoints de sleutel toegang heeft.
  2. Creditquotum: Stel aangepaste creditlimieten in om het gebruik te beheren.
  3. IP-allowlisting: Beperk de sleutel tot specifieke IP-adressen of CIDR-bereiken. Requests van IP-adressen die niet op de allowlist staan, worden afgewezen met een 403-fout. Meer informatie.

Onthoud dat je API-sleutel geheim is. Deel deze niet met anderen en stel deze niet bloot in client-sidecode (browsers, apps).

Alle API-requests moeten je API-sleutel in een xi-api-key HTTP-header bevatten, als volgt:

xi-api-key: ELEVENLABS_API_KEY

Requests uitvoeren

Je kunt de onderstaande opdracht in je terminal plakken om je eerste API-request uit te voeren. Vervang $ELEVENLABS_API_KEY door je geheime API-sleutel.

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

Voorbeeld met het Python-pakket elevenlabs:

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

Voorbeeld met het Node.js-pakket elevenlabs:

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

Tokens voor eenmalig gebruik

Voor bepaalde endpoints kun je tokens voor eenmalig gebruik gebruiken om je requests te authenticeren. Deze tokens zijn beperkt geldig en kun je gebruiken om verbinding te maken met de API zonder je API-sleutel bloot te stellen, bijvoorbeeld vanaf de client-side.

Zie de documentatie over tokens voor eenmalig gebruik voor meer informatie.