API reference

Uwierzytelnianie API

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

Klucze API

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

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

  1. Ograniczenie zakresu: Ogranicz dostęp, określają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ądarkach, aplikacjach).

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

xi-api-key: ELEVENLABS_API_KEY

Wysyłanie żądań

Wklej poniższe polecenie w terminalu, aby uruchomić pierwsze żądanie 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żywać tokenów jednorazowych do uwierzytelniania żądań. Są one 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.