ElevenLabs
ElevenLabs es un componente que transforma cualquier texto en audio. Utiliza la potente API de Eleven Labs para generar voces naturales y de alta calidad. En el dashboard, simplemente introduces el texto y eliges la voz y el modelo que prefieras; el componente devuelve el audio codificado en Base64, listo para reproducir o almacenar.
¿Cómo funciona?
Cuando envías el texto a ElevenLabs, el componente hace una llamada HTTP a la API de Eleven Labs. La API procesa el texto y devuelve un archivo de audio. El componente convierte ese archivo en una cadena Base64 y lo entrega como un objeto Message
. Así, el flujo de trabajo puede usar el audio directamente sin preocuparse por formatos de archivo.
Entradas
Campos de Entrada
- Custom Voice ID: Si ya tienes un ID de voz personalizado, introdúcelo aquí. Si lo dejas vacío, se usará la voz seleccionada en el campo Voice.
- Model: Elige el modelo de síntesis de voz que deseas usar. Los modelos varían en calidad y velocidad.
- Text: Escribe el texto que quieres convertir a voz. Puedes introducir texto plano o un objeto
Message
que contenga texto. - Voice: Selecciona la voz que quieres que pronuncie el texto. Esta opción solo se usa si no se proporciona un Custom Voice ID.
Nota importante: Este componente necesita una credencial de tipo Eleven Labs API.
- Configura la credencial en la sección de credenciales de Nappai.
- Selecciona esa credencial en el campo Credential del componente.
Salidas
- Audio Base64: El audio generado se devuelve como una cadena Base64 dentro de un objeto
Message
. Puedes usarlo para reproducirlo en un reproductor de audio, guardarlo en un archivo o enviarlo a otro componente.
Ejemplo de Uso
- Añade el componente ElevenLabs al flujo de trabajo.
- Configura las entradas:
Text
:"Hola, bienvenido a Nappai. Este es un ejemplo de voz generada."
Voice
:"Rachel"
(o la voz que prefieras)Model
:"eleven_monolingual_v1"
Custom Voice ID
: (dejar vacío si no tienes uno)
- Selecciona la credencial de Eleven Labs en el campo Credential.
- Ejecuta el flujo.
- El componente devuelve un objeto
Message
con el campoAudio Base64
. - Conecta la salida a un Reproductor de Audio o a un Almacén de Archivos según tu necesidad.
Componentes Relacionados
- Audio Player – Reproduce el audio generado.
- File Storage – Guarda el audio Base64 en un archivo.
Consejos y Mejores Prácticas
- Usa voces de prueba: Antes de usar voces personalizadas, prueba con voces estándar para asegurarte de que el resultado cumple tus expectativas.
- Controla el tamaño del audio: Si el texto es muy largo, considera dividirlo en párrafos para evitar tiempos de espera largos.
- Revisa la política de uso: Asegúrate de que tu uso de la API de Eleven Labs cumpla con sus términos de servicio.
Consideraciones de Seguridad
- Protege tu API Key: La credencial de Eleven Labs contiene tu clave secreta. No la compartas ni la expongas en el código fuente.
- Limita el acceso: Configura permisos adecuados en la sección de credenciales para que solo los usuarios autorizados puedan usar el componente.
- Monitorea el uso: Revisa el consumo de la API en el panel de Eleven Labs para evitar sobrecostos inesperados.