Platform

Sleutellimieten en regels

Stel per API-sleutel grenzen in die passen bij het doel: hoeveel hij mag uitgeven, hoe snel, welke modellen, vanaf waar en hoelang. Dat kan bij het aanmaken van een sleutel van op elk moment via API-sleutels → Bewerken.

De regels

Regel	Bij overschrijding	Fout
Maandbudget (USD)	Verzoeken worden geweigerd tot de volgende maand (UTC)	`402 key_budget_exceeded`
Dagbudget (USD)	Geweigerd tot middernacht UTC	`402 key_daily_budget_exceeded`
Verzoeklimiet (verzoeken per minuut)	Tijdelijk geweigerd, met `retry-after`	`429 rate_limit_exceeded`
Vervaldatum	De sleutel werkt niet meer	`401 expired_api_key`
Toegestane modellen	Andere modellen worden geweigerd	`403 model_not_allowed`
Toegestane IP-adressen	Verzoeken vanaf andere adressen worden geweigerd	`403 ip_not_allowed`

Geweigerde verzoeken worden nooit in rekening gebracht. Voor budgetten telt ook mee wat lopende verzoeken van de sleutel hebben gereserveerd (zie Facturering). Een verzoek dat een budget zou kunnen overschrijden, wordt dus geweigerd voordat het begint. Bereikt een antwoord onderweg de budgetlimiet, dan stopt het met de bijbehorende budgetfout. Wijzigingen zijn overal binnen 15 seconden van kracht. Je workspacesaldo geldt voor elke sleutel: als het niet genoeg is voor een verzoek, krijgt dat verzoek 402 insufficient_quota.

Toegestane modellen

Kies de modellen die je wilt: tekst, afbeeldingen of video. Een sleutel die bijvoorbeeld beperkt is tot gpt-6-sol en gemini-3.7-flash kan geen andere modellen aanroepen, en slimme routering gebruikt alleen alternatieven uit die lijst. Als je Zurelay Auto toestaat, kan de sleutel elk model gebruiken dat Auto kiest.

Toegestane IP-adressen

Losse adressen en CIDR-bereiken, IPv4 en IPv6, maximaal 100 per sleutel. We controleren het adres waar je verzoek op het internet vandaan komt (achter een proxy van NAT is dat het adres van de proxy).

Voorbeelden

203.0.113.7          one address
198.51.100.0/24      a range of 256 addresses
2001:db8::/32        an IPv6 range

Serverlessplatforms en sommige clouds versturen verzoeken vanaf wisselende adressen. Gebruik een bereik dat je provider voor uitgaand verkeer publiceert, van stel voor die sleutels geen IP-beperkingen in en vertrouw op de andere regels.

Budgetten in de praktijk

Geef elke app of omgeving een eigen sleutel en budget, zodat één uit de hand gelopen lus niet je hele saldo kan verbruiken.
Een dagbudget begrenst de gevolgen van een bug dezelfde dag; een maandbudget begrenst de rekening.
Op de pagina API-sleutels zie je per sleutel de uitgaven van vandaag en deze maand naast de budgetten.

Vragen, of ontbreekt er iets? Vraag het ons supportteam en je krijgt antwoord per e-mail, meestal binnen een minuut.