Saltearse al contenido

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.

  1. Configura la credencial en la sección de credenciales de Nappai.
  2. 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

  1. Añade el componente ElevenLabs al flujo de trabajo.
  2. 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)
  3. Selecciona la credencial de Eleven Labs en el campo Credential.
  4. Ejecuta el flujo.
  5. El componente devuelve un objeto Message con el campo Audio Base64.
  6. 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.