1. Comprender los límites de tasa
La limitación de tasa se refiere a las reglas que regulan con qué frecuencia la API de un usuario puede acceder a los servicios de nuestra plataforma dentro de una ventana de tiempo determinada. Sus objetivos son:- Prevenir el abuso y el uso indebido de la API: Al establecer un límite superior para la frecuencia de solicitudes, limitamos el tráfico anormal o no intencionado.
- Garantizar una asignación justa de recursos: Evitamos que un pequeño número de usuarios monopolice los recursos del sistema, para que todos puedan acceder al servicio en igualdad de condiciones.
- Mantener el rendimiento y la fiabilidad de la API: Al suavizar los picos de tráfico, estabilizamos los tiempos de respuesta y reducimos las tasas de fallo debidas a la sobrecarga, mejorando la calidad general del servicio.
- Proteger la estabilidad del sistema: Los límites de tasa ayudan a absorber ráfagas repentinas de tráfico, evitando que los picos de alta concurrencia sobrecarguen nuestra infraestructura.
2. Métricas de limitación de tasa
Para nuestros modelos de imagen y video, utilizamos dos métricas principales de limitación de tasa:- IPM (Images Per Minute): El número de imágenes que un modelo de imagen puede generar por minuto.
- RPM (Requests Per Minute): El número de solicitudes de API que un modelo de video puede gestionar por minuto.
3. Límites de tasa predeterminados
Para distintos modelos, nuestra plataforma aplica estrategias de limitación de tasa diferenciadas en función del consumo de recursos computacionales de cada modelo.IPM
El límite de IPM (Images Per Minute) controla el número de imágenes que pueden generarse por minuto. Los valores de IPM predeterminados para cada modelo se muestran en la siguiente tabla.RPM
El límite de RPM (Requests Per Minute) controla el número de solicitudes de API permitidas por minuto. Los valores de RPM predeterminados para cada modelo se proporcionan en la siguiente tabla.4. Gestión de los límites de tasa
¿Cómo supervisar los límites de tasa?
Si tus solicitudes de API superan la tasa permitida, la API devolverá:- Código de estado HTTP: 429 Too Many Requests
- Cuerpo de la respuesta: Un mensaje que indica que se ha superado el límite de tasa.
Mejores prácticas
Para evitar activar los límites de tasa, puedes:- Implementar limitación de solicitudes del lado del cliente: Respeta los límites de tasa de la plataforma controlando la tasa de solicitudes de tu aplicación, asegurándote de no enviar demasiadas llamadas en un periodo corto.
- Usar retroceso exponencial en los reintentos: Cuando recibas una respuesta de límite de tasa (por ejemplo, HTTP 429), espera cada vez más tiempo entre intentos de reintento en lugar de reintentar inmediatamente, reduciendo la carga sobre el servicio.
- Supervisar tu uso de la API: Realiza un seguimiento y registra continuamente tus recuentos de solicitudes, frecuencias y cualquier respuesta de error para poder ajustar tus patrones de uso de forma proactiva.
Cuando alcanzas los límites de tasa
Si recibes una respuesta HTTP 429 (“Too Many Requests”), puedes:- Reintentar más tarde: Espera un breve periodo antes de enviar tu solicitud de nuevo.
- Optimizar tus solicitudes: Reduce la frecuencia de las llamadas para permanecer dentro de los límites de tasa de la plataforma.
- Solicitar un límite de tasa más alto: Si necesitas un límite de tasa más alto, completa el formulario de contacto en Quotas&Limits para ponerte en contacto con nosotros.