Hoppa till navigering
API reference

API-autentisering

Lär dig hur du autentiserar dina API-begäranden till ElevenLabs

API-nycklar

ElevenLabs API använder API-nycklar för autentisering. Varje API-begäran måste innehålla din API-nyckel, som används för att autentisera dina begäranden och följa upp din användningskvot.

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

  1. Begränsning av åtkomstområde: Begränsa åtkomsten genom att ange vilka API-slutpunkter nyckeln kan använda.
  2. Kreditkvot: Ange anpassade kreditgränser för att styra användningen.
  3. IP-tillåtelselista: Begränsa nyckeln till specifika IP-adresser eller CIDR-intervall. Begäranden från IP-adresser som inte finns på tillåtelselistan avvisas med felet 403. Läs mer.

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

Alla API-begäranden ska innehålla din API-nyckel i HTTP-headern xi-api-key enligt följande:

xi-api-key: ELEVENLABS_API_KEY

Göra begäranden

Du kan klistra in kommandot nedan i terminalen för att köra din första API-begäran. Kom ihåg 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 begäranden. Dessa token är giltiga under en begränsad tid och kan användas för att ansluta till API:et utan att exponera din API-nyckel, till exempel från klientsidan.

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