Skip to main content
Die Postzee API erzwingt Rate-Limits, um eine faire Nutzung und Plattformstabilitaet zu gewaehrleisten. Die Limits variieren je nach Endpunkttyp.

​
Rate-Limits nach Endpunkt

Endpunkte mit expliziten Pro-Minute-Limits ueberschreiben den globalen Standard. Die meisten Lese-Endpunkte (Kanaele, Credits, Posts, Jobs) fallen unter das globale 30/Stunde-Limit. KI-Generierungsendpunkte haben eigene hoeherfrequente Limits.

​
MCP-Server-Rate-Limits

​
Rate-Limit-Header

Wenn Sie sich einem Rate-Limit naehern oder es ueberschreiten, gibt die API Standard-Rate-Limit-Header zurueck:

​
Limit ueberschritten

Wenn Sie das Rate-Limit ueberschreiten, gibt die API zurueck:
Was zu tun ist: Warten Sie, bis das Rate-Limit-Zeitfenster zurueckgesetzt wird (pruefen Sie den X-RateLimit-Reset-Header), und wiederholen Sie dann Ihre Anfrage.

​
Best Practices

  • KI-Generierungsanfragen verteilen — begrenzen Sie diese auf 10 pro Minute fuer Bild-/Videogenerierung
  • Modelllisten cachen — die verfuegbaren Modelle aendern sich nicht haeufig, cachen Sie daher Antworten von /image-models und /video-models
  • Job-Status vernuenftig abfragen — alle 5-10 Sekunden pruefen, nicht jede Sekunde
  • Batch-Operationen verwenden — bei der Generierung mehrerer Bilder verwenden Sie generate-media mit quantity: 2-4 anstelle mehrerer generate-image-Aufrufe
  • 429-Fehler elegant behandeln — implementieren Sie exponentielles Backoff bei Rate-Limiting

​
Limits nach Plan

Die Rate-Limits sind fuer alle kostenpflichtigen Plaene gleich. Die API ist im Free-Plan nicht verfuegbar.