Vai alla navigazione
API reference

Autenticazione API

Scopri come autenticare le richieste alla tua API ElevenLabs

Chiavi API

L’API di ElevenLabs usa chiavi API per l’autenticazione. Ogni richiesta all’API deve includere la tua chiave API, usata per autenticare le richieste e monitorare la quota di utilizzo.

Puoi configurare ogni chiave API con le seguenti restrizioni:

  1. Restrizione dell’ambito: imposta restrizioni di accesso limitando gli endpoint API a cui la chiave può accedere.
  2. Quota di crediti: definisci limiti di crediti personalizzati per controllare l’utilizzo.
  3. Allowlist IP: limita la chiave a indirizzi IP o intervalli CIDR specifici. Le richieste da IP non inclusi nell’allowlist vengono rifiutate con un errore 403. Scopri di più.

Ricorda che la tua chiave API è segreta. Non condividerla con altri e non esporla nel codice lato client (browser, app).

Tutte le richieste API devono includere la tua chiave API in un header HTTP xi-api-key, come segue:

xi-api-key: ELEVENLABS_API_KEY

Effettuare richieste

Puoi incollare il comando qui sotto nel terminale per eseguire la tua prima richiesta API. Assicurati di sostituire $ELEVENLABS_API_KEY con la tua chiave API segreta.

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

Esempio con il pacchetto Python elevenlabs:

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

Esempio con il pacchetto Node.js elevenlabs:

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

Token monouso

Per alcuni endpoint, puoi usare token monouso per autenticare le richieste. Questi token sono validi per un periodo limitato e possono essere usati per connetterti all’API senza esporre la chiave API, ad esempio dal lato client.

Per maggiori informazioni, consulta la documentazione sui token monouso.