Limitación de Velocidad - OpenModex

Límites de Velocidad

Los límites de velocidad se aplican por clave API según su nivel de suscripción:

Nivel	Solicitudes/min	Tokens/min
Free	30	60,000
Pro	120	500,000
Enterprise	300+	Personalizado

Encabezados de Límite de Velocidad

Cada respuesta incluye encabezados de límite de velocidad:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
X-RateLimit-Reset: 1700000060

Encabezado	Descripción
`X-RateLimit-Limit`	Máximo de solicitudes por ventana
`X-RateLimit-Remaining`	Solicitudes restantes en la ventana
`X-RateLimit-Reset`	Marca de tiempo Unix cuando la ventana se reinicia

Manejo de Errores 429

Cuando se excede el límite de velocidad, recibirá una respuesta 429 Too Many Requests:

{
  "error": {
    "message": "Rate limit exceeded. Please retry after 2 seconds.",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

Reintentos Automáticos

Todos los SDKs oficiales reintentan automáticamente en errores 429 con backoff exponencial:

const client = new OpenModex({
  apiKey: 'omx_sk_...',
  maxRetries: 3, // default: 2
});

El retraso de reintento sigue: min(500ms × 2^attempt, 5000ms)

Mejores Prácticas

Use backoff exponencial — los SDKs manejan esto automáticamente
Monitoree la cuota restante — verifique los encabezados X-RateLimit-Remaining
Use streaming — las solicitudes de streaming cuentan como una sola solicitud independientemente de la longitud de la respuesta
Actualice su nivel — si constantemente alcanza los límites, considere actualizar
Distribuya la carga — use múltiples claves API para diferentes servicios