Vai alla navigazione

Guida rapida a ElevenAPI

Scopri come effettuare la tua prima richiesta all'API di ElevenLabs.

Al termine di questa guida avrai configurato ElevenLabs nel tuo progetto e potrai effettuare la tua prima richiesta di Text to Speech. Puoi farlo in due modi: lasciare che il tuo agente di coding esegua la configurazione oppure farla manualmente.

Per le guide su altre funzionalità — streaming, clonazione vocale, Speech to Text — consulta la sezione Tutorial.

Configura con il tuo agente di coding

Non ti servono un account o una chiave API prima di iniziare. Incolla questo nel tuo agente di coding:

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

La CLI di ElevenLabs fa il resto e indica al tuo agente ogni passaggio. Il browser si aprirà una volta, così potrai accedere o creare un account e fare clic su Authorize. La chiave viene salvata nel file env del tuo progetto (.env.local oppure .env in un progetto Python) e tenuta fuori da git; non viene mai mostrata nella chat. L’agente ti chiederà quindi cosa desideri creare, installerà l’SDK, aggiungerà il codice alla tua app e ti chiederà se inviare una richiesta di test.

Se il tuo agente viene eseguito in un luogo non raggiungibile dal browser, ad esempio su una macchina remota tramite SSH o in una sandbox cloud, la CLI ti chiederà di creare una chiave e di incollarla nel file env, quindi continuerà. Il comando richiede Node.js per npx. Se non lo hai, installa la CLI di ElevenLabs con Homebrew (macOS e Linux) o Scoop (Windows), oppure aggiornala se la possiedi già (brew upgrade elevenlabs, scoop update elevenlabs), e chiedi al tuo agente di eseguire invece elevenlabs onboard init.

Configura manualmente

1

Crea una chiave API

Crea qui una chiave API nella dashboard, che userai per accedere all’API in modo sicuro.

Archivia la chiave come segreto gestito e passala agli SDK come variabile d’ambiente tramite un file .env oppure direttamente nella configurazione della tua app, in base alle tue preferenze.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Installa l'SDK

Useremo anche la libreria dotenv per caricare la nostra chiave API da una variabile d’ambiente.

pip install elevenlabs
pip install python-dotenv

Per riprodurre l’audio attraverso gli altoparlanti, potrebbe esserti chiesto di installare MPV e/o ffmpeg.

3

Effettua la tua prima richiesta

Crea un nuovo file denominato example.py o example.mts, a seconda del linguaggio scelto, e aggiungi il codice seguente:

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os
load_dotenv()
elevenlabs = ElevenLabs(
api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
text="The first move is what sets everything in motion.",
voice_id="JBFqnCBsd6RMkjVDRZzb", # "George" - browse voices at elevenlabs.io/app/voice-library
model_id="eleven_v4",
output_format="mp3_44100_128",
)
play(audio)

Quindi eseguilo:

python example.py

Dovresti sentire l’audio riprodotto dagli altoparlanti.

Passaggi successivi