Hiciste clic en Generar y obtuviste un error, o el indicador de carga se detuvo sin producir audio. Esta página cubre las causas más comunes y cómo solucionar cada una. Empieza desde arriba y ve avanzando.
Lista de verificación rápida
Revisa estos puntos primero. La mayoría de los problemas son uno de estos cuatro:
- Sin créditos
- Voz no válida o faltante
- El texto es demasiado largo para el modelo elegido
- El sitio no está conectado a TTSWP
Cada uno de estos muestra un mensaje específico en el popup de error. Lee el texto exacto antes de sacar conclusiones.
Causa 1: Sin créditos
Mensaje de error: "Créditos insuficientes" o "Se te agotaron los créditos"
Por qué ocurre: Tus créditos mensuales de TTSWP están agotados, no tienes saldo de recarga y no hay una clave BYOK de ElevenLabs conectada.
Opciones de solución:
- Espera el reinicio mensual (si tienes un plan de pago). Consulta la fecha de reinicio en Texto a Voz - Texto a Voz - TTSWP → Mi plan y créditos.
- Compra un paquete de recarga.
- Conecta tu clave API de ElevenLabs para obtener créditos adicionales.
- Actualiza tu plan.
Causa 2: Voz no válida o faltante
Mensaje de error: "La voz seleccionada ya no está disponible en tu cuenta de ElevenLabs. Por favor, elige una voz diferente."
Por qué ocurre: La voz que tenías seleccionada como predeterminada fue eliminada de tu cuenta de ElevenLabs. Suele ocurrir cuando se borra una voz clonada o cuando un ID de voz se almacenó incorrectamente.
Solución:
- Ve a Texto a Voz - TTSWP → Voces.
- Haz clic en Actualizar voces en la barra superior.
- Elige una voz diferente de la lista.
- Haz clic en Seleccionar.
- Regenera la entrada.
Causa 3: El texto es demasiado largo para el modelo
Mensaje de error: "Este texto es más largo de lo que ElevenLabs acepta para este modelo. Por favor, acórtalo o elige un modelo diferente."
Por qué ocurre: Cada modelo de ElevenLabs tiene un límite de caracteres por solicitud. Flash y Turbo v2.5 permiten 40.000 caracteres, pero Multilingual v2 solo permite 10.000 y Eleven v3 solo 3.000. Tu entrada es más larga de lo que admite el modelo elegido.
Opciones de solución:
- Cambia a un modelo con un límite mayor en la página de Voces
- Divide la entrada en secciones más cortas con múltiples shortcodes
- Elimina contenido con la clase
no-audioo selectores CSS
Consulta la tabla de límites de modelos en Elige una voz.
Causa 4: El sitio no está conectado
Síntoma: La página de Resumen muestra una Tarjeta de Conexión morada en lugar de tus créditos.
Solución: Conecta tu sitio primero. Sin una conexión, la generación siempre falla.
Causas menos comunes
Tu clave BYOK de ElevenLabs no es válida
Error: "Falló la síntesis TTS: Clave API no válida"
Solución: Consulta Conecta tu propia clave de ElevenLabs y actualiza la clave.
Tiempo de espera de red agotado
Error: "Falló la síntesis TTS: Se agotó el tiempo de la operación"
Por qué ocurre: Textos muy largos o una ruta de red lenta hacia ElevenLabs.
Solución:
- Inténtalo de nuevo. Los tiempos de espera transitorios suelen resolverse en el siguiente intento.
- Si sigue ocurriendo, prueba un modelo más rápido (Flash v2.5) y un texto más corto.
Problema de pago de la suscripción
Error: "Tu suscripción tiene un pago fallido o incompleto."
Por qué: Tu suscripción de ElevenLabs tiene una factura vencida. Esto solo aplica cuando usas BYOK con una cuenta de pago de ElevenLabs.
Solución: Inicia sesión en elevenlabs.io y paga la factura.
Incompatibilidad de idioma entre voz y modelo
Error: "El modelo X no admite el código de idioma Y"
Por qué: No todos los modelos admiten todos los idiomas. Es menos frecuente a partir de la versión 3.1.7, que normaliza los códigos de idioma de WordPress.
Solución: Elige un idioma diferente en la página de Voces, o cambia al modelo Flash v2.5, que admite la mayoría de los idiomas populares.
Dónde revisar el mensaje de error
Cuando la generación falla desde la lista de entradas, la columna TTS muestra un pequeño ícono de error. Pasa el cursor para ver el mensaje. También puedes revisar Mis estadísticas → Actividad reciente para ver un registro de los intentos recientes.
Si el mensaje de error no es claro, cópialo y consulta esta página o Soporte.