Przejdź do nawigacji
API reference

Uwierzytelnianie API

Dowiedz się, jak uwierzytelniać żądania do API ElevenLabs

Klucze API

Pomiń klucz. Niech skonfiguruje go twój agent programistyczny.

Wklej to do Claude Code, Cursor lub Codex. Narzędzie zaloguje cię lub utworzy konto, utworzy klucz i doda SDK do projektu.

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

Zobacz, jak to działa lub przeczytaj kod źródłowy polecenia onboard, aby dokładnie zobaczyć, co przekazuje twojemu agentowi.

API ElevenLabs używa kluczy API do uwierzytelniania. Każde żądanie do API musi zawierać klucz API, który uwierzytelnia żądania i śledzi limit użycia.

Dla każdego klucza API możesz ustawić te ograniczenia:

  1. Ograniczenie zakresu: Ogranicz dostęp, wskazując endpointy API dostępne dla klucza.
  2. Limit kredytów: Ustaw własne limity kredytów, by kontrolować użycie.
  3. Lista dozwolonych adresów IP: Ogranicz klucz do konkretnych adresów IP lub zakresów CIDR. Żądania z adresów IP spoza listy są odrzucane z błędem 403. Dowiedz się więcej.

Pamiętaj, że klucz API jest tajny. Nie udostępniaj go innym ani nie ujawniaj w kodzie po stronie klienta (przeglądarki, aplikacje).

Wszystkie żądania do API powinny zawierać klucz API w nagłówku HTTP xi-api-key:

xi-api-key: ELEVENLABS_API_KEY

Wysyłanie żądań

Możesz wkleić poniższe polecenie do terminala, aby wykonać pierwsze żądanie do API. Zastąp $ELEVENLABS_API_KEY swoim tajnym kluczem API.

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

Przykład z pakietem Python elevenlabs:

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

Przykład z pakietem Node.js elevenlabs:

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

Tokeny jednorazowe

W przypadku niektórych endpointów możesz użyć tokenów jednorazowych do uwierzytelniania żądań. Są ważne przez ograniczony czas i pozwalają łączyć się z API bez ujawniania klucza API, na przykład po stronie klienta.

Więcej informacji znajdziesz w dokumentacji Tokeny jednorazowe.