Rate limits og kvoter

Hver nøgle har to grænser: en burst-grænse pr. minut og en månedlig kvote. Begge står i headerne på hvert svar, så du aldrig behøver at gætte.

To grænser

Burst pr. minut — hvor mange kald nøglen må lave inden for et vindue på 60 sekunder. Beskytter mod løbske løkker.
Månedlig kvote — hvor mange kald planen indeholder pr. kalendermåned. Nulstilles den 1. i måneden kl. 00:00 UTC.

Svar-headerehttp

X-RateLimit-Limit: 1200        # burst-loft pr. minut for din plan
X-RateLimit-Remaining: 1187    # tilbage i det aktuelle minut
X-RateLimit-Reset: 1790239832  # unix-tid (sekunder), hvor minut-vinduet nulstilles
X-Quota-Limit: 5000            # månedens kvote
X-Quota-Remaining: 4211        # tilbage af månedens kvote
X-Quota-Reset: 1790812800      # unix-tid (sekunder) for den 1. i næste måned, UTC
Retry-After: 13                # kun på 429: sekunder du skal vente

I TypeScript-SDK’et får du headerne parset med *WithMeta()-metoderne.

Grænser pr. plan

Plan	Kald pr. måned	Burst pr. minut	Over kvoten
Free	5.000	1.200	Afvises med `429`
Starter	100.000	3.600	1 kr. pr. 1.000 kald
Pro	500.000	9.000	1 kr. pr. 1.000 kald
Scale	2.000.000	18.000	1 kr. pr. 1.000 kald
Enterprise	Ubegrænset	60.000	—

Free er et hårdt loft: når kvoten er brugt, svarer API’et 429 resten af måneden. På de betalte planer fortsætter kaldene over kvoten og faktureres som overforbrug. På Enterprise viser X-Quota-Limit og X-Quota-Remaining værdien unlimited. Priser og indhold står på /priser.

Testnøgler (gf_test_) har deres eget loft på 25.000 kald pr. måned, uafhængigt af planen, og samme burst-grænse som planen. Se Godkendelse og nøgler.

Hvad tæller som et kald

Et almindeligt opslag tæller som ét kald.
Et :batch-kald tæller ét kald pr. unikt id i listen. Dubletter tælles kun én gang. Se Batch og eksport.
En eksport tæller ét kald pr. unikt id, og id’er, der ikke kunne hentes, krediteres tilbage.
/v1/dhm/profil tæller ét kald pr. punkt i profilen; /v1/dhm/terraen tæller ét kald for hele nettet.
Et vellykket tools/call på MCP-serveren tæller som ét kald.
Svar med 5xx og 504 lægges tilbage i kvoten. Se Fejl og statuskoder.

Når du rammer en grænse

Grænse	Kendetegn	Hvad du gør
Burst	`429` med `X-RateLimit-*`; `Retry-After` er sekunderne til minut-vinduet nulstilles.	Vent `Retry-After` sekunder og prøv igen. Spred kaldene jævnt.
Månedens kvote (Free) eller sandbox-loftet	`429` med `X-Quota-Remaining: 0`; `Retry-After` peger på næste måned.	Prøv ikke igen automatisk. Opgradér eller skift til en live-nøgle.

Hold øje med X-Quota-Remaining i din egen overvågning. Har du webhooks, udsendes usage.threshold, når månedens forbrug passerer 80 % og 100 % af kvoten.