Hoppa till navigering
API reference

API-autentisering

Lär dig hur du autentiserar dina API-förfrågningar till ElevenLabs

API-nycklar

Hoppa över nyckeln. Låt din kodningsagent konfigurera den.

Klistra in detta i Claude Code, Cursor eller Codex. Det loggar in dig eller skapar ett konto, skapar en nyckel och lägger till SDK:t i ditt projekt.

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

Se hur det fungerar, eller läs källkoden för kommandot onboard för att se exakt vad det säger till din agent.

ElevenLabs API använder API-nycklar för autentisering. Varje förfrågan till API:t måste inkludera din API-nyckel, som används för att autentisera dina förfrågningar och spåra användningskvoten.

Varje API-nyckel kan konfigureras med följande begränsningar:

  1. Omfångsbegränsning: Ange åtkomstbegränsningar genom att begränsa vilka API-slutpunkter nyckeln kan komma åt.
  2. Kreditkvot: Definiera anpassade kreditgränser för att kontrollera användningen.
  3. IP-tillåtelselista: Begränsa nyckeln till specifika IP-adresser eller CIDR-intervall. Förfrågningar från IP-adresser som inte finns på tillåtelselistan avvisas med ett 403-fel. Läs mer.

Kom ihåg att din API-nyckel är hemlig. Dela den inte med andra och exponera den inte i kod på klientsidan (webbläsare, appar).

Alla API-förfrågningar bör inkludera din API-nyckel i en HTTP-header med namnet xi-api-key enligt följande:

xi-api-key: ELEVENLABS_API_KEY

Göra förfrågningar

Du kan klistra in kommandot nedan i din terminal för att köra din första API-förfrågan. Se till att ersätta $ELEVENLABS_API_KEY med din hemliga API-nyckel.

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

Exempel med Python-paketet elevenlabs:

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

Exempel med Node.js-paketet elevenlabs:

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

Engångstoken

För vissa slutpunkter kan du använda engångstoken för att autentisera dina förfrågningar. Dessa token är giltiga under en begränsad tid och kan användas för att ansluta till API:t utan att exponera din API-nyckel, till exempel från klientsidan.

Se dokumentationen för engångstoken för mer information.