Vai alla navigazione
Tutorial

Guida rapida al doppiaggio

Scopri come doppiare file audio e video in più lingue con l’API di doppiaggio.

Questa guida mostra come doppiare un file multimediale in un’altra lingua con l’API di doppiaggio. In questo esempio crei un progetto di doppiaggio da un file audio in inglese e generi un doppiaggio in spagnolo.

Un progetto di doppiaggio ha due parti: un progetto, che contiene una sorgente multimediale e la relativa trascrizione, e una o più lingue di destinazione, ognuna delle quali produce un output doppiato in una singola lingua. Crei un progetto, attendi che la sorgente venga trascritta, aggiungi una lingua e poi scarichi il doppiaggio completato.

La creazione di un progetto comporta l’addebito anticipato di una lingua — il costo minimo di un progetto di doppiaggio. Questo prepagamento copre la prima lingua di destinazione: la prima lingua che aggiungi lo utilizza e ogni lingua aggiuntiva viene addebitata separatamente. Consulta Quanto costa il doppiaggio? per i dettagli.

Le lingue sono specificate come tag BCP-47, ad esempio es o fr-CA. Consulta le lingue e i dialetti supportati per tutti i valori accettati.

Uso dell’API di doppiaggio

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 secret gestito e passala agli SDK come variabile d’ambiente tramite un file .env oppure direttamente nella configurazione della tua app, a seconda delle 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

L’esempio Python usa la libreria requests per scaricare l’audio doppiato. Installala con pip install requests.

3

Effettua la richiesta API

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

# example.py
import os
import time
import requests
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
load_dotenv()
elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)
# 1. Create a project from a source URL
project = elevenlabs.dubbing.project.create(
    source_url="https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3",
    source_language="en",
    reference="Quickstart dub",
)
# 2. Wait for the source media to be transcribed
while True:
    project = elevenlabs.dubbing.project.get(project.project_id)
    if project.status == "ready":
        break
    if project.status == "failed":
        raise RuntimeError("Project preparation failed")
    print("Preparing project...")
    time.sleep(5)
# 3. Add a Spanish language target
language = elevenlabs.dubbing.project.language.create(
    project.project_id,
    target_language="es",
)
# 4. Wait for the dub to finish generating
while True:
    language = elevenlabs.dubbing.project.language.get(
        project.project_id, language.language_id
    )
    if language.status == "completed":
        break
    if language.status == "failed":
        raise RuntimeError("Dub generation failed")
    print("Generating dub...")
    time.sleep(5)
# 5. Download the dubbed audio from the signed URL
audio = requests.get(language.outputs.lossless_audio)
with open("dubbed.wav", "wb") as f:
    f.write(audio.content)
print("Saved dubbed audio to dubbed.wav")

L’URL di download in outputs.lossless_audio è firmato e scade circa un’ora dopo la sua emissione. Se è scaduto, recupera nuovamente la lingua per ottenere un nuovo URL.

Poi eseguilo:

python example.py

L’audio doppiato viene salvato in dubbed.wav nella directory di lavoro.

Gestione degli errori

Se l’aggiunta di una lingua non riesce, aggiungi di nuovo la stessa lingua al progetto esistente anziché crearne uno nuovo. Il progetto e la sua sorgente trascritta sono riutilizzabili, quindi riprovare con la lingua è più rapido ed evita di pagare una seconda volta il costo minimo di una lingua.

Crea un nuovo progetto solo se il progetto stesso raggiunge lo stato failed durante la preparazione, il che significa che la sorgente non ha potuto essere trascritta. Controlla il file o l’URL sorgente, quindi crea un nuovo progetto.

I workspace Enterprise possono rivedere e correggere la trascrizione sorgente prima di aggiungere una lingua, ottenendo traduzioni più accurate. Consulta Perfeziona e rigenera un doppiaggio.

Passaggi successivi

Usa la tua trascrizione

Crea un progetto da una trascrizione esistente e fornisci le tue traduzioni

Perfeziona e rigenera un doppiaggio

Modifica la trascrizione sorgente e le traduzioni, quindi rigenera il doppiaggio

Doppia in più lingue

Aggiungi più lingue di destinazione a un singolo progetto

Riferimento API

Esplora tutti i parametri e i formati di risposta dell’API di doppiaggio