Rate Limits und Credit-/Ausgabenobergrenzen für die Pioneer API

​

Anfrage-Rate-Kontingente und Credit-/Ausgabenobergrenzen für die Pioneer API, Umgang mit 429-Fehlern und wie Sie höhere Limits anfordern

​

Anfrage-Rate-Limits

1. Edge-Rate-Limit – wird immer auf jede Anfrage am Load Balancer angewendet, bevor sie die API erreicht, unabhängig von Endpunkt oder Authentifizierung. Aggregiert nach der vom Edge beobachteten IP-Adresse, die nicht immer die tatsächliche Client-IP Ihrer Anwendung ist (zum Beispiel werden Anfragen, die über einen gemeinsamen Egress-Hop geproxyt werden, gemeinsam aggregiert). Limit: 100.000 Anfragen / 60 Sekunden.
2. Limit pro Endpunkt – die meisten unten aufgeführten Endpunkte erzwingen ihr eigenes Limit, das auf Ihr Abrechnungsteam bezogen ist (mit Fallback auf den API-Schlüssel, dann Benutzer, dann Client-IP bei nicht authentifizierten Anfragen). Dies ist das Limit, das einen normalen, authentifizierten Aufrufer regelt. Es ersetzt den generischen Pro-IP-Standard für diesen Endpunkt, statt sich darauf zu stapeln – der Pro-IP-Standard gilt nur für Endpunkte ohne aufgeführte Überschreibung.

​

Credit-Limits und Ausgabenobergrenze für Overage

• 402 Payment Required, wenn Ihre enthaltenen Credits aufgebraucht sind und kein ausgabefähiges Guthaben verfügbar ist (code: "out_of_credits").
• 403 Forbidden, wenn die maximale monatliche Overage-Ausgabe Ihres Tarifs erreicht wurde (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"
}

​

Umgang mit 429-Antworten

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.")

​

Höhere Limits anfordern