Bei FlowModels greifen mehrere Grenzen, die leicht verwechselt werden. Manche gelten für einen einzelnen Schlüssel, andere für dein ganzes Team. Hier siehst du sie auf einen Blick. Es greift immer die Grenze, die zuerst erreicht ist.
Die Grenzen im Überblick
| Grenze | Gilt für | Wo einstellen | Fehler, wenn erreicht |
|---|---|---|---|
| Monatliches Limit des Schlüssels | einen Schlüssel | API-Schlüssel → Bearbeiten | 429 spend_limit_exceeded |
| Ausgabenlimit pro Monat | alle Schlüssel des Teams | Abrechnung | 429 spend_limit_exceeded |
| Guthaben (Prepaid) oder Kreditrahmen (Postpaid) | das ganze Team | Abrechnung | 429 insufficient_quota |
| Anfragen pro Minute | Team, je Schlüssel enger einstellbar | API-Schlüssel → Bearbeiten | 429 rate_limit_exceeded |
| Gleichzeitig laufende Anfragen | das ganze Team | ergibt sich aus der Stufe | 429 concurrent_requests_exceeded |
Budget meint hier immer Euro, Anfragelimit meint die Zahl der Aufrufe. Die Eurobeträge werden vor dem Aufruf geprüft: Offene Reservierungen laufender Anfragen zählen mit, ein abgelehnter Aufruf kostet nichts.
Je Schlüssel
Das monatliche Limit legst du beim Anlegen oder Bearbeiten eines Schlüssels fest, als ganzen Eurobetrag von 1 bis 100.000, siehe API-Schlüssel anlegen. Ohne Eintrag hat der Schlüssel kein eigenes Limit. Damit grenzt du zum Beispiel ein Testsystem oder einen Kunden ab.
Auch das Anfragelimit je Minute kannst du je Schlüssel senken, aber nie über das Teamlimit hinaus. Die Einzelheiten stehen in API-Schlüssel bearbeiten, erneuern oder sperren.
Für das ganze Team
Das Ausgabenlimit pro Monat und die Warnschwellen richtest du unter Abrechnung ein, siehe Ausgabenlimit und Warnschwellen einrichten. Die Stufe bestimmt die Anfragen je Minute und die gleichzeitigen Anfragen des ganzen Teams, siehe Anfragelimit: So funktionieren die Stufen.
Alle Euro-Grenzen beziehen sich auf den laufenden Kalendermonat und beginnen zum Monatswechsel neu.
Für Endnutzer deiner Anwendung
Für einzelne Endnutzer gibt es kein eigenes Budget und kein eigenes Limit. Willst du deine Kunden begrenzen, machst du das in deiner Anwendung, zum Beispiel anhand der Kosten aus GET /v1/usage mit group_by=end_user, siehe Verbrauch per API auswerten. Oder du gibst jedem Kunden einen eigenen Schlüssel mit eigenem Monatslimit.
Welche Grenze dich gerade stoppt
429 insufficient_quotaodercredit_balance_exhausted: Lade Guthaben auf. Eine Erhöhung des Ausgabenlimits hilft hier nicht.429 spend_limit_exceededoderperiod_spend_limit_exceeded: Das Monatslimit des Schlüssels oder des Teams ist erreicht. Eine Aufladung hilft nicht, hebe das Limit an oder warte bis zum Monatswechsel.429 rate_limit_exceededund429 concurrent_requests_exceeded: Warte die Sekunden ausRetry-Afterab.
Mehr zu den Codes steht in Fehlermeldungen von FlowModels verstehen. Deine Anwendung kann die aktuellen Werte mit GET /v1/key und GET /v1/credits abfragen, siehe Guthaben und Schlüsselgrenzen per API abfragen.