Límites de tasa

Los límites de tasa protegen a Pixapi y a los proveedores de modelos upstream de picos repentinos de tráfico. Los límites pueden variar según el plan, la familia de modelos y el endpoint.

Señales comunes

Pixapi puede devolver 429 rate_limited cuando la clave o cuenta actual excede su tasa de peticiones permitida.

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please retry later."
  }
}

Comportamiento del cliente

• Encola trabajos en ráfagas en tu backend.
• Usa backoff exponencial con jitter.
• Evita reintentar generación de medios sin comprobar el estado de la tarea.
• Divide el tráfico de producción, staging y desarrollo entre claves de API separadas.

Backoff con jitter

function backoff(attempt: number) {
  const base = Math.min(8000, 500 * 2 ** attempt);
  return base + Math.floor(Math.random() * 250);
}

Aumentar límites

Si ejecutas cargas de alto volumen, contacta con soporte e incluye el volumen esperado de peticiones, la combinación de modelos y la ventana de tráfico pico.