Cómo pedir ayuda

Una dirección y ya: support@uttera.ai. Contesta una persona.

No hay formulario, ni número de ticket, ni un robot preguntándote si has probado a reiniciar. Cuando el volumen lo pida montaremos algo con más maquinaria, y se dirá aquí; mientras tanto, un correo llega antes y se responde igual.

Qué mandarnos

Con esto casi siempre basta para saber qué pasó sin tener que pedirte nada más:

Y si el problema es con un audio concreto, no hace falta que nos lo envíes para empezar. Casi todo se diagnostica con el identificador de la petición. Si en algún momento necesitáramos el audio, te lo pediremos explicando para qué — que es la única forma en que una grabación tuya puede acabar en nuestras manos más de los segundos que dura procesarla.

Cuánto tardamos

Esto es a lo que nos comprometemos. Es tiempo de primera respuesta en días laborables, no tiempo de resolución: hay averías que se arreglan en diez minutos y otras que no, pero saber que alguien lo está mirando no debería depender de la suerte.

Si algo está roto de verdad

Si crees que has encontrado un fallo nuestro —no una duda de uso—, dilo en el asunto. Lo tratamos antes que cualquier otra cosa, y si resulta que tenías razón lo publicaremos: en esta documentación si cambia algo de lo que aquí está escrito, y en el registro de cambios si toca al servicio.

Y si lo que has encontrado es un problema de seguridad, escríbelo a la misma dirección con [seguridad] en el asunto y sin publicarlo mientras tanto. Te responderemos con lo que sepamos y con un plazo.

Preguntas frecuentes

Empezar y cuenta

¿Cómo consigo una clave de API? Regístrate en app.uttera.ai y la generas en tu cuenta. Viaja en la cabecera Authorization: Bearer sk-....

¿Puedo tener varias claves? Sí. Crea una por integración (web, móvil, un conector…) para poder revocar una sin tocar las demás.

¿Cómo revoco o roto una clave? Desde tu cuenta: borras la vieja y creas una nueva. La revocación es inmediata.

¿Hay plan gratuito? Sí, con un cupo mensual para probar. Lo que incluye cada plan está en Planes.

¿Cómo subo o bajo de plan? Desde tu cuenta. Al subir se cobra la diferencia prorrateada y el nuevo plan aplica al momento.

¿Hay planes anuales? Sí, con descuento sobre el mensual. Ver Planes.

¿Cómo veo cuánto llevo gastado? En tu cuenta tienes el consumo, el crédito restante y un historial de peticiones.

¿Qué pasa cuando se me acaba el crédito? Recibes avisos al 80% y al 100%. Al agotarlo, las peticiones de pago devuelven 402 hasta que recargues o subas de plan.

¿Puedo comprar crédito suelto sin cambiar de plan? Sí, hay paquetes de créditos que se suman a tu cupo.

¿Cómo pago? Con tarjeta, y también con criptomoneda (Bitcoin). La factura lleva tu CIF/IVA si lo indicas en tu cuenta.

Errores y códigos

401 — no autorizado. La clave falta o es incorrecta. Revisa que mandas Authorization: Bearer <tu-clave> y que la clave sigue activa.

403 — prohibido. Tu plan no incluye esa acción. Mira qué incluye cada plan en Planes y súbelo si lo necesitas.

413 — demasiado grande. El audio o el texto supera el límite de esa acción. Reduce o acorta el fichero, o usa el modo asíncrono. Los límites están en Referencia.

402 — créditos insuficientes. Se agotó tu crédito del mes. Compra un paquete de créditos o sube de plan.

429 — demasiadas peticiones. Vas muy rápido. Reintenta con una espera creciente (backoff) entre llamadas.

500 / 503 — error del servidor. Normalmente temporal. Reintenta; si persiste, escríbenos con el X-Request-Id.

504 en un resumen largo. El modo síncrono de /v1/summarize corta a los 10 minutos y no cobra. Para audios largos usa el modo asíncrono, sin ese tope.

¿Qué es el X-Request-Id? Una cabecera de la respuesta que identifica tu petición exacta. Mándanoslo al pedir ayuda y localizamos qué pasó sin pedirte nada más.

Transcripción

¿Qué formatos de audio aceptáis? wav, mp3, m4a, ogg, opus, flac, webm, aac y amr.

¿Hay un tamaño máximo de audio? Sí, y hay un tope de duración en el modo síncrono. Para ficheros grandes o largos, usa el modo asíncrono. Detalle en Referencia.

¿Qué idiomas transcribe? Muchos; la lista por acción está en Referencia. Si la detección falla, pasa el idioma explícito.

Mi transcripción salió vacía o con errores. Suele ser audio sin voz/silencio, idioma mal detectado (fija language) o un fichero corrupto. Comprueba el audio y reintenta.

¿Me dice quién habla y cuándo? Sí, con la diarización: devuelve segmentos con hablante y marca de tiempo.

¿Es compatible con la API de OpenAI? Sí. Apunta tu SDK de OpenAI a nuestro endpoint y usa los mismos nombres (p. ej. whisper-1). Ver Integración.

Voz y clonación

¿Qué voces y qué idiomas hay? Un catálogo de voces por idioma; la lista está en Estudio.

¿Puedo clonar una voz? Sí: das una muestra corta de la voz y el texto a decir. Hay un límite de caracteres por petición (ver Referencia).

¿Necesito permiso para clonar una voz? Sí. Una voz es un dato biométrico: clona solo tu propia voz o una con consentimiento explícito. Clonar a un tercero para suplantarlo es ilegal.

¿El audio generado lleva marca de agua? Sí, una marca inaudible que exige el Reglamento de IA de la UE (art. 50.2). No se puede desactivar.

Traducción

¿Traducís texto y voz? Ambos: a texto, o traducido y hablado.

¿Puedo mantener mi voz al traducir? Sí: al traducir voz puedes conservar la voz original del hablante en lugar de una del catálogo.

¿Qué idiomas de traducción hay? En Referencia. Algunos códigos tienen peculiaridades (p. ej. noruego o chino); la doc lo indica.

Resumen e informe verificable

¿Podéis resumir una grabación? Sí: transcribe y devuelve un resumen estructurado (puntos clave, datos, tareas, quién habló).

¿Qué es el informe verificable? Un PDF firmado con un grafo de evidencia que cualquiera puede comprobar: enlaza cada afirmación con el momento del audio. Ver Informe verificable.

¿Cómo verifico un informe? Con la acción de verificación: comprueba la firma (Ed25519) y que el PDF no se ha modificado.

Sonidos y música

¿Generáis efectos de sonido? Sí, a partir de una descripción (una puerta, lluvia, pasos), y también escenas sonoras con varios eventos mezclados.

¿Y música? Sí, una pieza a partir de una descripción. El coste depende de la duración × pasos de calidad; ajusta ambos.

¿Qué licencia tiene la música generada? Para tu uso según los términos; detalle en la doc de Sonidos y música. Lleva la marca de agua del art. 50.2.

Pronunciación

¿Analizáis la pronunciación? Sí: comparas una grabación con una frase de referencia y te devuelve precisión, fonemas esperados vs oídos y errores agrupados. Ver Pronunciar.

Privacidad, legal y datos

¿Entrenáis con mis datos? No. Tu audio y tu texto no se usan para entrenar ni se reutilizan. Ver Privacidad.

¿Dónde se procesan mis datos? En la UE, en infraestructura propia. Ver Privacidad y Sostenibilidad.

¿Cuánto tiempo guardáis el audio? En los trabajos asíncronos, el material se cifra por trabajo y se borra automáticamente pasado un plazo corto. Detalle en Privacidad.

¿Tenéis RGPD / acuerdo de tratamiento (DPA)? Sí. Ver Marco legal.

¿Puedo pedir que borréis mis datos? Sí, escríbenos. Ver Marco legal.

Integraciones y conectores

¿Funciona con el SDK de OpenAI? Sí: cambia la base_url a nuestro endpoint y reutilizas tu código. Ver Integración.

¿Tenéis conector para Claude / ChatGPT / Gemini? Sí, una Skill que sube el audio desde el sandbox del modelo sin que el audio pase por el LLM. Ver Conectores.

¿Y un servidor MCP? Sí (solo audio por URL pública). Para ficheros locales, usa la Skill. Ver Conectores.

¿Slack y Telegram? Sí, hay bots que transcriben el audio que les mandas. Ver Conectores.

¿n8n? Sí, hay nodos de Uttera para n8n.

¿Tenéis apps para usarlo sin programar? Sí, apps web instalables: Resumen, Intérprete (voz↔voz) y Coach de pronunciación.

La Skill me da error de red en Claude. En cuentas Team/Enterprise, un admin debe permitir api.uttera.ai en la lista blanca de red de la organización. En planes individuales no hace falta. Ver Conectores.

Asíncrono y webhooks

¿Puedo mandar trabajos largos sin esperar? Sí: el modo asíncrono encola el trabajo y te avisa por webhook al terminar, sin el tope de 10 min del síncrono.

¿Los webhooks van firmados? Sí, con HMAC, para que verifiques que vienen de nosotros.