Límites de velocidad y topes de créditos / gasto para la API de Pioneer

​

Cuotas de velocidad de solicitudes y topes de créditos / gasto para la API de Pioneer, cómo manejar los errores 429 y cómo solicitar límites más altos

​

Límites de velocidad de solicitudes

1. Límite de velocidad en el borde — se aplica siempre a cada solicitud en el balanceador de carga, antes de que llegue a la API, independientemente del endpoint o la autenticación. Se agrega por la dirección IP que observa el borde, que no siempre es la IP real del cliente de tu aplicación (por ejemplo, las solicitudes que pasan por un salto de salida compartido se agregan juntas). Límite: 100.000 solicitudes / 60 segundos.
2. Límite por endpoint — la mayoría de los endpoints de abajo aplican su propio límite ceñido a tu equipo de facturación (recurriendo a la clave de API, luego al usuario, y luego a la IP del cliente para solicitudes no autenticadas). Este es el límite que gobierna a un llamador normal autenticado. Reemplaza el valor por defecto genérico por IP para ese endpoint en lugar de sumarse sobre él — el valor por defecto por IP solo gobierna los endpoints sin una anulación listada.

​

Límites de créditos y tope de gasto por excedente

• 402 Payment Required cuando tus créditos incluidos están agotados y no hay saldo utilizable del que extraer (code: "out_of_credits").
• 403 Forbidden cuando se ha alcanzado el gasto máximo mensual por excedente de tu plan (code: "credit_ceiling_reached").

{
  "code": "out_of_credits",
  "message": "You've used your included credits. Add credits or enable auto top-up.",
  "resolution_url": "https://agent.pioneer.ai/credits"
}

​

Manejo de respuestas 429

HTTP/2 429
retry-after: 3
content-type: application/json

{
  "detail": "Rate limit exceeded: ..."
}

import time
import requests

def call_with_retry(url, headers, payload, max_retries=5):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, json=payload)

        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 1))
            print(f"Rate limited. Retrying in {retry_after}s...")
            time.sleep(retry_after)
            continue

        response.raise_for_status()
        return response.json()

    raise RuntimeError("Max retries exceeded.")

​

Solicitar límites más altos