Descripción general
Los límites de concurrencia aseguran un uso justo y la estabilidad de la API. La cantidad de jobs que pueden ejecutarse a la vez depende de tu plan.Límites por plan
Tu plan determina tu concurrencia, que se establece por modelo y se cuenta por usuario. Los planes de nivel superior pueden ejecutar más jobs al mismo tiempo.Contacta al equipo comercial para conocer los detalles del plan Enterprise y la concurrencia personalizada.
Backlog de jobs
Cuando el backlog está disponible, los jobs que envías por encima de tu límite de concurrencia se aceptan constatus: "backlogged". Comienzan, en el orden en que se enviaron, a medida que terminan los jobs en ejecución. No hay un límite de backlog independiente.
Cuando el backlog no está disponible, un job adicional puede rechazarse con HTTP 429 en lugar de ponerse en cola. El límite es aproximado: una ráfaga breve aún puede aceptarse por encima de él. Ante un 429, reintenta con retroceso después de que terminen los jobs en curso. El cuerpo y los encabezados se describen en Errores y depuración.
Mejores prácticas
- Implementa retroceso exponencial — espera progresivamente más tiempo entre reintentos
- Encola solicitudes en el cliente — una ráfaga puede aceptarse por encima del límite, así que no dependas de la API para detener la siguiente solicitud
- Monitorea tu uso — lleva un seguimiento del conteo de solicitudes para mantenerte dentro de los límites
- Usa webhooks — reduce las solicitudes de sondeo usando webhooks para la finalización de jobs
Próximos pasos
Claves de API y facturación
Monitorea tu uso de la API y sus métricas
Webhooks
Reduce el sondeo usando webhooks
Errores y depuración
Cuerpos de 429, retroceso y códigos de jobs fallidos