Plattform

Schlüssellimits und Regeln

Begrenze jeden API-Schlüssel auf seinen Zweck: Ausgaben, Tempo, Modelle, Herkunft der Anfragen und Gültigkeitsdauer. Lege die Regeln beim Erstellen des Schlüssels fest oder ändere sie jederzeit unter API-Schlüssel → Bearbeiten.

Die Regeln

Regel	Was passiert, wenn das Limit erreicht ist	Fehler
Monatsbudget (USD)	Anfragen werden bis zum nächsten Monat abgelehnt (UTC)	`402 key_budget_exceeded`
Tagesbudget (USD)	Bis Mitternacht UTC abgelehnt	`402 key_daily_budget_exceeded`
Ratenlimit (Anfragen pro Minute)	Kurzzeitig abgelehnt, mit `retry-after`	`429 rate_limit_exceeded`
Ablaufdatum	Der Schlüssel funktioniert nicht mehr	`401 expired_api_key`
Erlaubte Modelle	Andere Modelle werden abgelehnt	`403 model_not_allowed`
Erlaubte IP-Adressen	Anfragen von anderen Adressen werden abgelehnt	`403 ip_not_allowed`

Abgelehnte Anfragen werden nie berechnet. Bei Budgets zählt auch, was laufende Anfragen des Schlüssels bereits reserviert haben (siehe Abrechnung). Eine Anfrage, die ein Budget überschreiten könnte, wird daher vor dem Start abgelehnt. Erreicht eine Antwort während der Verarbeitung das Budget, wird sie mit dem entsprechenden Fehler gestoppt. Änderungen gelten überall innerhalb von 15 Sekunden. Dein Workspace-Guthaben gilt für alle Schlüssel: Reicht es für eine Anfrage nicht aus, erhält sie 402 insufficient_quota.

Erlaubte Modelle

Wähle beliebige Modelle für Text, Bild oder Video. Ein Schlüssel, der etwa auf gpt-6-sol und gemini-3.7-flash beschränkt ist, kann keine anderen Modelle aufrufen. Auch Smart Routing nutzt nur Alternativen aus dieser Liste. Wenn du Zurelay Auto erlaubst, kann der Schlüssel jedes Modell nutzen, das Auto auswählt.

Erlaubte IP-Adressen

Einzelne Adressen und CIDR-Bereiche, IPv4 und IPv6, bis zu 100 pro Schlüssel. Geprüft wird die öffentliche Adresse, von der deine Anfrage kommt (hinter einem Proxy oder NAT ist das die Adresse des Proxys).

Beispiele

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

Serverless-Plattformen und manche Clouds senden Anfragen von wechselnden Adressen. Nutze einen von deinem Anbieter veröffentlichten Bereich für ausgehende Verbindungen. Oder lass IP-Adressen für diese Schlüssel uneingeschränkt und nutze die anderen Regeln.

Budgets in der Praxis

Gib jeder App und jeder Umgebung einen eigenen Schlüssel mit eigenem Budget. So kann eine Endlosschleife nicht das gesamte Guthaben aufbrauchen.
Ein Tagesbudget fängt einen Fehler noch am selben Tag ab; ein Monatsbudget begrenzt die Rechnung.
Auf der Seite für API-Schlüssel siehst du neben den Budgets, wie viel jeder Schlüssel heute und diesen Monat ausgegeben hat.

Fragen oder fehlt etwas? Frag unser Support-Team und wir antworten per E-Mail, meist innerhalb einer Minute.