Visítanos en BITAM Show — Stand 105a, Madrid, 28 y 29 de octubre
Inicio de Filmo

Cómo funcionan los límites de uso

Por qué la API responde “demasiadas peticiones” cuando una clave envía demasiadas en un minuto, y qué hacer.

Cada clave de API puede hacer un número limitado de peticiones por minuto. El límite protege tu cuenta: un script que falla no puede ralentizar Filmo para tu equipo ni para las demás herramientas que usan la API.

Cuáles son los límites

QuéLímiteA quién se aplica
Cualquier petición120 por minutoA cada clave de API, entre todo lo que hace
Consultas de disponibilidad30 por minutoA cada clave de API, para artículos, personal y vehículos juntos

Las consultas de disponibilidad tienen un límite propio y más bajo porque son las preguntas más pesadas que responde Filmo, y además cuentan dentro del límite general. Los límites son los mismos en todos los planes.

Un asistente de IA conectado a Filmo está sujeto a los mismos límites: cada cosa que consulta o cambia es una petición de la conexión con la que trabaja.

Qué pasa cuando una clave se pasa

Filmo no rompe nada ni pierde datos. Responde a las peticiones de más con “demasiadas peticiones” y los segundos que hay que esperar. Cuando acaba el minuto, la clave vuelve a funcionar.

Si una integración o un asistente dice “demasiadas peticiones”

  1. Espera un minuto. El límite cuenta por minuto, así que casi siempre basta con eso.
  2. Comprueba qué está usando la clave. Abre «API y MCP» en Configuración, luego «Claves de API», y mira el nombre de la clave y cuándo se usó por última vez. Una clave compartida por varias herramientas suma todas sus peticiones.
  3. Da a cada herramienta su propia clave. Así una herramienta muy activa no gasta las peticiones de otra. Consulta Genera una clave de API.
  4. Pide a quien construyó la integración que espacie sus peticiones. Una integración bien hecha espera el tiempo que Filmo le pide y pide solo lo que cambió, en lugar de leerlo todo una y otra vez.

Traer muchos datos de golpe

Una importación puntual de miles de registros puede llegar al límite sin remedio. Repártela en el tiempo, o pide a quien la hace que siga la guía para desarrolladores de abajo.

Para quien construye la integración

Cada respuesta dice a la integración cuántas peticiones le quedan, y una rechazada indica cuánto esperar. Los detalles, con ejemplos de reintento, están en la guía de límites de uso, y los límites que importan a los asistentes de IA en la guía de límites de MCP.

Recursos relacionados

Preguntas frecuentes

¿Te ha resuelto la duda este artículo?