Qué acepta la API, y qué no
Los límites que acepta la API, tal y como están puestos hoy.
Antes de nada: qué es esto
Liora Flow traduce voz en directo: alguien habla en una sala y quien escucha lo oye en su idioma unos segundos después. De ese motor salen también las grabaciones, los documentos y los subtítulos, y salen igual de bien.
Lo que se puede esperar:
- Una grabación tarda alrededor de una décima parte de lo que dura. Una hora de audio, unos seis minutos.
- El directo manda sobre el diferido, y eso no va a cambiar: un trabajo en cola espera si hay una sala emitiendo. En horas cargadas, un trabajo tarda más.
- Varios idiomas a la vez del mismo audio, con precio por minuto de voz en vez de por idioma: el primero entero y cada uno de más un 35 %. Cuáles hay, abajo.
- Se cobra el habla y no la duración. Una grabación de una hora con veinte minutos de voz paga veinte minutos.
A qué idiomas se traduce
Hoy son nueve: alemán, chino, español, francés, inglés, italiano, portugués, ruso y ucraniano. Se pueden pedir todos a la vez del mismo audio.
La lista crece, así que la buena es la que enseña el panel: al elegir los idiomas de una sala salen los que hay en ese momento. Si necesitas uno que no está, dilo.
No confundir con los idiomas del panel y de la app, que son trece: eso es en qué idioma están los botones, no a qué se traduce.
Lo que se contesta al momento
| Ruta | Límite | Qué pasa si te pasas |
|---|---|---|
POST /api/translate |
10.000 caracteres | 413 con TEXT_TOO_LARGE y a dónde ir |
POST /api/transcribe-audio |
25 segundos de audio (~900 KB) | 413 con AUDIO_TOO_LARGE |
⚠️Esas dos son de la aplicación, no de la API de integración
Van con el token de una sesión de Liora, no con una llave de API. Desde tus
sistemas, lo que hay es la cola: POST /api/v1/jobs, con tu llave.
Hay un tope de un mega por petición, así que lo que no quepa se contesta en JSON —con su código y su motivo— antes de gastar el viaje.
Los dos errores llevan queue: "/admin/jobs", que es a dónde va lo que no cabe.
Lo que se pone en cola
| Qué | Límite |
|---|---|
| Texto | 100.000 caracteres (~35 páginas) |
| Documento | 20 MB — txt, md, csv, docx, odt, pdf, doc, rtf |
| Grabación de audio | 240 minutos y 800 MB |
| Vídeo | 60 minutos y 800 MB — de un vídeo sólo se usa el sonido, y pesa cincuenta veces más; para una sesión larga, saca el audio y sube eso |
| Formatos de audio | wav, mp3, ogg, opus, m4a, aac, flac, wma, amr, aiff |
| Vídeo (se le saca el sonido) | mp4, mov, mkv, avi, webm |
| Trabajos en cola a la vez | 3 por cliente |
| Subida sin terminar | se tira a las 24 horas |
Una grabación se sube en bloques de cuatro megas y el servidor sabe por qué byte va: si se corta la conexión, se sigue desde ahí en vez de empezar de cero.
Di cuánto va a pesar al abrir el trabajo (bytes en el cuerpo). Con eso, un
fichero que no cabe se rechaza antes de mandarlo —en vez de después de media hora
de subida— y cada bloque te contesta percent, que es lo que necesita una barra
de progreso que sobreviva a una reconexión.
Qué se guarda y cuánto
Del directo no se guarda nada: se traduce al vuelo y desaparece.
De un trabajo en diferido:
| Qué | Cuánto |
|---|---|
| El fichero que subiste | se borra al acabar el trabajo |
| La transcripción y las traducciones | 7 días, en la carpeta de tu cuenta |
| Cuánto se habló y cuánto costó | mientras exista la cuenta: es tu factura |
Cuánto tarda
Regla de andar por casa: una grabación tarda alrededor de una décima parte de lo que dura. Una hora de audio, unos seis minutos, y con la salvedad de arriba: si hay directo, el diferido espera.
Los idiomas de más casi no cuentan: el audio se oye una vez y de ahí salen todos. Saber quién habla es lo único que suma tiempo de forma apreciable.
Cuánto cuesta
El crédito es un minuto de voz traducida a un idioma. Se cobra el habla, no la duración del fichero: una grabación de una hora con veinte minutos de voz paga veinte minutos.
| Qué te llevas | Precio |
|---|---|
| Voz traducida en directo | 0,20 €/min (paquete pequeño) |
| Cada idioma de más | ×0,35, no ×1 |
| Grabación → texto traducido | 6 €/hora de habla |
| Grabación → sólo transcripción | 3 €/hora de habla |
| Texto suelto | 40 € por millón de caracteres |
| Saber quién habla | +2 €/hora de habla |
El precio se sabe antes de ponerse en cola: al terminar de subir, la respuesta dice cuántos segundos de habla se han medido y cuántos créditos va a costar.
Los formatos de salida
De un trabajo terminado se descarga, por idioma:
txt— el texto de corrido, con quién habla delante de cada intervención.srtyvtt— subtítulos con marcas de tiempo, sólo para grabaciones.json— los turnos con sus tiempos y el texto de cada idioma, para procesarlo con lo tuyo.
El acta y el resumen de un fichero
Van sobre un trabajo que ya se ha pagado, así que no cuestan nada de más — pero sin transcripción no hay acta.
| Puerta | Qué hace |
|---|---|
POST /api/v1/jobs/{id}/summary |
Encarga el resumen. Contesta 202, no 200: se está haciendo |
GET /api/v1/jobs/{id}/summary |
Lo recoge cuando está |
GET /api/v1/jobs/{id}/result?format=acta |
El acta, en txt. También acta.md, acta.json y acta.pdf |
Pedirlo dos veces no cobra dos veces. El encargo se apunta con la llave
job-<id>, así que un doble clic —o dos pestañas— contesta lo mismo y con coste
cero. Medido: 202 con credits_seconds: 0 y un solo encargo apuntado.
Lo que se cobra son los segundos de habla, por una tarifa que cambia según se pida el resumen o el acta entera. No depende del número de capas: el resumen pide tres —resumen, decisiones y tareas— y cuesta lo mismo que cuando pedía una.
Si este despliegue no tiene resumidor, la puerta contesta 503 NO_SUMMARIES.
Es un «aquí no, hoy no» y no un «eso no existe»: la puerta está y el trabajo sigue
entero, lo que falta es el motor detrás.
El acta de una reunión
Se compone al pedirla y no se guarda: dura lo que duran las frases de las que
está hecha, quince días (plazos.QuinceDias).
| Medido el 31/08/2026 sobre 2.400 frases (4 h de reunión) | |
|---|---|
GET /api/scheduled-meetings/:id/acta |
18 ms |
…/acta/txt |
11 ms · 465 KB |
…/acta/md |
11 ms · 479 KB |
…/acta/pdf |
150 ms · 886 KB · 161 páginas |
Tope: 60 descargas al minuto por IP. Es el único límite de la API puesto por lo que cuesta una respuesta y no por estar la puerta abierta.
El pdf no siempre se ofrece. Sólo si hay una letra instalada que sepa
dibujar todos los caracteres del documento; si no, formats trae txt, md y
json, y
pedir el pdf contesta 409 NO_PDF_FOR_THAT_TEXT. Un PDF sin esos dibujos sale
en blanco y al extraerle el texto lo devuelve entero, así que un 200 no
prueba nada aquí.