FlowModels

Anfragelimit: So funktionieren die Stufen

Veröffentlicht am 11. November 2026

Wie viele Anfragen dein Team an FlowModels stellen darf, hängt von seiner Stufe ab. Jedes Team beginnt in Stufe 1 und steigt automatisch auf, je mehr es bezahlt hat. Die Stufe bestimmt zwei Grenzen: die Anfragen je Minute und die Zahl der Anfragen, die gleichzeitig laufen dürfen.

Die vier Stufen

Stufe Anfragen je Minute Gleichzeitig laufende Anfragen Automatischer Aufstieg ab
1 60 10 Start
2 600 25 5 €
3 2.000 50 100 €
4 6.000 100 500 €

Beide Grenzen gelten für dein ganzes Team, also für alle Schlüssel zusammen.

Wo du deine Stufe siehst

Öffne im Dashboard den Punkt Abrechnung. Im Kasten Anfragelimit steht, in welcher Stufe dein Team ist, welche Grenzen gelten und ab welchem Betrag du in die nächste Stufe aufsteigst.

Der Kasten „Anfragelimit“ in der Abrechnung mit der aktuellen Stufe

Deine Anwendung kann die Werte auch selbst abfragen: GET /v1/key liefert unter limits die Stufe, das wirksame Limit je Minute und die gleichzeitig erlaubten Anfragen.

Wie der Aufstieg funktioniert

  • Prepaid: Gezählt wird die Summe deiner bezahlten Aufladungen. Rückbuchungen werden abgezogen, Gutschriften aus Kulanz zählen nicht.
  • Postpaid: Gezählt wird der abgerechnete Verbrauch. Teams, die auf Postpaid umgestellt werden, kommen direkt in Stufe 4.

Der Aufstieg passiert automatisch, direkt nach einer bezahlten Aufladung und zusätzlich bei einer regelmäßigen Prüfung im Hintergrund. Eine Stufe steigt nur, sie sinkt nie von selbst. Brauchst du früher eine höhere Stufe, als dein bisheriger Umsatz ergibt, sprich den Support an.

Limit für einen einzelnen Schlüssel

Du kannst einem Schlüssel ein eigenes Limit für Anfragen pro Minute geben, zum Beispiel damit ein Testsystem nicht das ganze Teamkontingent verbraucht. Dieses Limit kann das Teamlimit nur senken, nie erhöhen. Du stellst es beim Bearbeiten des Schlüssels ein, siehe API-Schlüssel bearbeiten, erneuern oder sperren. Die Grenze für gleichzeitig laufende Anfragen teilen sich dagegen immer alle Schlüssel des Teams.

Was passiert, wenn das Limit erreicht ist

Die API antwortet dann mit HTTP 429:

  • rate_limit_exceeded: Das Kontingent je Minute ist ausgeschöpft, entweder das des Teams oder das eigene Limit des Schlüssels.
  • concurrent_requests_exceeded: Es laufen bereits so viele Anfragen gleichzeitig, wie deine Stufe erlaubt.

In beiden Fällen nennt der Header Retry-After die Wartezeit in Sekunden. Abgelehnte Anfragen kosten nichts. Baue in deine Anwendung eine Wiederholung mit Wartezeit ein und schicke bei großen Stapelverarbeitungen weniger Anfragen parallel. Weitere Fehlercodes erklärt Fehlermeldungen von FlowModels verstehen.

Gut zu wissen

Abgelehnte Anfragen siehst du im Anfrageprotokoll mit dem Status Zu viele Anfragen. Wenn dort viele davon auftauchen, ist das ein Zeichen, dass deine Anwendung zu viel auf einmal schickt oder dein Team eine höhere Stufe braucht.

War dieser Artikel hilfreich?

Zurück zu Modelle, Limits & Fehler