Guía de inicio rápido de Doblaje
Guía de inicio rápido de Doblaje
Aprende a doblar archivos de audio y vídeo a distintos idiomas con la API de Doblaje.
Esta guía te muestra cómo doblar un archivo multimedia a otro idioma con la API de Doblaje. En este ejemplo, creas un proyecto de doblaje a partir de un archivo de audio en inglés y generas un doblaje en español.
Un proyecto de doblaje tiene dos partes: un proyecto, que contiene una fuente multimedia y su transcripción, y uno o varios idiomas de destino, cada uno de los cuales genera un resultado doblado en un único idioma. Creas un proyecto, esperas a que se transcriba su fuente, añades un idioma y después descargas el doblaje terminado.
Al crear un proyecto, se te cobra por un idioma por adelantado: el coste mínimo de un proyecto de doblaje. Esto prepaga tu primer idioma de destino: el primer idioma que añades lo consume, y cada idioma adicional se cobra por separado. Consulta ¿Cuánto cuesta el doblaje? para obtener más información.
Los idiomas se especifican como etiquetas BCP-47, por ejemplo es o fr-CA. Consulta los idiomas y dialectos compatibles para ver todos los valores admitidos.
Usar la API de Doblaje
Crear una clave de API
Crea una clave de API aquí, en el panel, que usarás para acceder a la API de forma segura.
Guarda la clave como un secreto gestionado y pásala a los SDK como variable de entorno mediante un archivo .env, o directamente en la configuración de tu aplicación, según prefieras.
Instalar el SDK
SDK
CLI
También usaremos la biblioteca dotenv para cargar nuestra clave de API desde una variable de entorno.
El ejemplo de Python utiliza la biblioteca requests para descargar el audio doblado.
Instálala con pip install requests.
Hacer la solicitud a la API
SDK
CLI
Crea un archivo llamado example.py o example.mts, según el lenguaje que elijas, y añade el siguiente código:
La URL de descarga de outputs.lossless_audio está firmada y caduca aproximadamente una hora después de emitirse. Recupera de nuevo el idioma para obtener una URL nueva si ha caducado.
Después, ejecútalo:
El audio doblado se guarda en dubbed.wav en tu directorio de trabajo.
Gestionar errores
Si no puedes añadir un idioma, vuelve a añadir el mismo idioma al proyecto existente en lugar de crear uno nuevo. El proyecto y su fuente transcrita se pueden reutilizar, por lo que reintentar el idioma es más rápido y evita pagar por segunda vez el coste mínimo de un idioma.
Crea un proyecto nuevo solo si el propio proyecto alcanza failed durante la preparación, lo que significa que no se ha podido transcribir su fuente. Comprueba el archivo o la URL de origen y crea un proyecto nuevo.
Los espacios de trabajo Enterprise pueden revisar y corregir la transcripción de origen antes de añadir un idioma, lo que genera traducciones más precisas. Consulta Perfeccionar y regenerar un doblaje.