Vai alla navigazione
API reference

Autenticazione API

Scopri come autenticare le tue richieste API di ElevenLabs

Chiavi API

Salta la chiave. Lascia che il tuo agente di coding la configuri.

Incolla questo in Claude Code, Cursor o Codex. Ti fa accedere o crea un account, crea una chiave e aggiunge l’SDK al tuo progetto.

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

Scopri come funziona oppure leggi il codice sorgente del comando onboard per vedere esattamente cosa comunica al tuo agente.

L’API di ElevenLabs utilizza 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.

Ogni chiave API può essere configurata 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 di IP: limita la chiave a indirizzi IP o intervalli CIDR specifici. Le richieste provenienti 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 né 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 seguente 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 tue richieste. Questi token sono validi per un periodo limitato e possono essere usati per connetterti all’API senza esporre la tua chiave API, ad esempio dal lato client.

Per ulteriori informazioni, consulta la documentazione sui token monouso.