Skip to navigation
API reference

API-authenticatie

Leer hoe je je ElevenLabs API-requests authenticeert

API-sleutels

Sla de sleutel over. Laat je codeeragent dit instellen.

Plak dit in Claude Code, Cursor of Codex. Hiermee log je in of maak je een account, maak je een sleutel en voeg je de SDK toe aan je project.

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

Bekijk hoe het werkt, of lees de broncode van de opdracht onboard om precies te zien wat deze je agent vertelt.

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 configureren met de volgende beperkingen:

  1. Scopelbeperking: Stel toegangsbeperkingen in door te beperken tot welke API-endpoints de sleutel toegang heeft.
  2. Creditquotum: Definieer aangepaste kredietlimieten om het gebruik te beheren.
  3. IP-allowlisting: Beperk de sleutel tot specifieke IP-adressen of CIDR-bereiken. Requests vanaf 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 bevatten in een xi-api-key HTTP-header, 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 kunnen worden gebruikt om verbinding te maken met de API zonder je API-sleutel bloot te stellen, bijvoorbeeld vanaf de client-side.

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