Ratenlimits
Jeder Schlüssel hat zwei Limits: Anfragen pro Minute und pro Tag (der Tag wird in UTC gezählt). Die Werte für Ihren Schlüssel zeigt GET /me im Feld rateLimit (rpm und rpd).
Jede Antwort auf eine authentifizierte Anfrage trägt den Zustand des Limits, das gerade näher an der Erschöpfung ist - auch Datei-Downloads (sie zählen ebenfalls zum Rate-Limit). Antworten, die vor der Prüfung des Schlüssels oder des Limits entstehen, tragen diese Header nicht: ungültiger Schlüssel (401), fehlerhafter Body (400), unbekannter Pfad (404), ungültige Query-Parameter (400 validation), fehlender Bereich (403 forbidden_scope), für einen Testschlüssel abgelehnter Schreibzugriff (403).
Im Browser (CORS) sind die Header RateLimit-*, Retry-After, Grem-Sandbox, X-Request-Id und Content-Range lesbar.
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| Header | Bedeutung |
|---|---|
RateLimit-Limit | erlaubte Anfragen im aktuellen Fenster |
RateLimit-Remaining | verbleibende Anfragen |
RateLimit-Reset | Sekunden bis zum Zurücksetzen des Fensters |
Über dem Limit kommt 429 mit title: rate_limited und einem Retry-After-Header. Das Ratenlimit ist ein technischer Schutz und berechnet nie etwas.
Beobachten Sie RateLimit-Remaining und verteilen Sie Anfragen zeitlich. Auch das Abfragen von Auftragsstatus zählt zum Ratenlimit, obwohl es kostenlos ist - fragen Sie nicht öfter als alle paar Sekunden ab oder wechseln Sie zu Webhooks.
Abrechnung
Einen separaten API-Tarif gibt es nicht: Der Zugriff ist Teil Ihres Abos, kostenpflichtige Aktionen werden vom selben Wallet abgebucht wie im Kabinett.
Ein kostenpflichtiger Aufruf hat zwei Teile:
- Der API-Aufruf. Aus dem im Tarif enthaltenen Aufrufkontingent. Darüber hinaus werden Aufrufe nach Verbrauch abgerechnet.
- Der Werkzeugpreis - so viel, wie dieselbe Aktion im Kabinett kostet (aus dem enthaltenen Kontingent oder aus dem Wallet).
API-Aufrufkontingent je Tarif:
| Tarif | API-Aufrufe pro Monat |
|---|---|
| Free | 100 |
| Start | 5.000 |
| PRO | 25.000 |
| MAX | 100.000 |
| Agency Start | 50.000 |
| Agency Growth | 250.000 |
| Agency Scale | unbegrenzt im Rahmen fairer Nutzung |
Andere Tarife sowie aktuelle Werkzeugkontingente und Preise finden Sie auf der Tarifseite im Kabinett.
Was kostet und was nicht
Die Abrechnungsklasse jeder Operation steht in /openapi.json, Feld x-grem-billing: free, api_call oder api_call+sku:... (Aufruf plus Werkzeugpreis).
| Kostenpflichtig | Kostenlos |
|---|---|
Werkzeuge starten (POST an Bewertung, Texte, Video, Foto, PDF, Website usw.) - Aufruf + Werkzeugpreis | alle Lesezugriffe (GET), einschließlich Auftragsabfragen und Downloads |
| Flyer und Bestätigung der Berichtsprüfung - nur Aufruf | Objekte: erstellen, ändern, löschen |
| Chatnachricht - Aufruf + Nachrichtenpreis | Leads und Swipe Match: erstellen, ändern, Ereignisse |
| Erstellen, Ändern und Löschen von Chatsitzungen - nur Aufruf | Bilder hochladen |
| Webhooks verwalten |
Eine abgelehnte Anfrage (4xx oder 5xx) verbraucht keinen API-Aufruf. Ausnahme ist 502 provider_error nach einer Zeitüberschreitung: Die Arbeit kann trotzdem fertig werden und berechnet werden - prüfen Sie GET /works (Fotoverbesserung, Website und Entwurf: im Kabinett oder unter Ihren Objekten). Eine Wiederholung der Express-Bewertung mit demselben Idempotency-Key liefert das Ergebnis, kostenlos (weder Bewertung noch API-Aufruf); bei anderen Werkzeugen bleibt der Schlüssel nach einer Zeitüberschreitung 15 Minuten belegt - prüfen Sie das Ergebnis, statt zu wiederholen.
Aufrufe, Ausgaben und Fehler je Schlüssel sehen Sie im Kabinett auf der Seite API, Reiter Analytik.
Verwandte Artikel
- Fehler -
402und429. - Idempotenz - sichere Wiederholungen ohne Doppelbelastung.