Vercel AI Gateway begrenzt Ausgaben pro Nutzer

Ein außer Kontrolle geratener Coding-Agent muss sich den finanziellen Not-Aus nicht länger mit der Produktionsanwendung teilen. Am 31. August 2026 führte Vercel AI Gateway Nutzerbudgets ein. Damit lassen sich die Ausgaben von API-Keys stoppen, die einem einzelnen Teammitglied zugeordnet sind, während ein dem Team zugeordneter Produktions-Key weiterläuft – vorausgesetzt, für diesen Key und das Team ist noch Budget verfügbar. Das verändert die Kontrolle über die Rechnung, nicht den Preis eines Modells.

Vercel AI Gateway in einem Satz

Personengebundene Agenten-Keys erhalten einen persönlichen Ausgabenrahmen, gemeinsam genutzte Produktions-Keys bleiben beim Team.

Damit ist das Prinzip bereits erklärt. Ein Nutzerbudget bündelt die Ausgaben sämtlicher AI Gateway API-Keys, die demselben Mitglied zugeordnet sind. Ist dieser Rahmen ausgeschöpft, liefern neue Anfragen über diese Keys den HTTP-Status 402 zurück. Datenverkehr außerhalb des betreffenden Nutzerbudgets kann dagegen weiterlaufen.

Vor dieser Neuerung konnte Vercel das Budget für das Team, ein Projekt oder einen einzelnen API-Key begrenzen. Die zusätzliche Nutzerebene ergänzt diese Kontrollen und löst ein anderes Problem: Eine Entwicklerin oder ein Entwickler kann mehrere Keys für Codex, Claude Code, Cursor oder einen anderen unbeaufsichtigten Workload einsetzen, während die Finanzverantwortlichen trotzdem eine gemeinsame Obergrenze für die gesamten Gateway-Ausgaben dieser Person benötigen.

Welche Ausgaben einem Nutzer zugerechnet werden

Entscheidend ist die Ausgabenzuordnung (Spend attribution). Sie ist nichts anderes als das Eigentümerlabel, das Vercel einem API-Key für die Budgetabrechnung zuweist.

Neue Keys werden standardmäßig einem Nutzer (User) zugeordnet. Ältere Keys ohne Zuordnung bleiben aus Gründen der Abwärtskompatibilität dem Team zugerechnet. Auch ein per API erstellter Key ohne metadata.spendAttribution zählt zum Team.

Daraus ergeben sich vier unterschiedliche Anfragepfade:

Die Ausgaben werden nicht auf diese Budgets aufgeteilt. Stattdessen landen sie gleichzeitig auf jedem zutreffenden Zähler. Eine Anfrage mit einem mitgliedsbezogenen Key muss in das Key-Budget, das Nutzerbudget des Mitglieds und das Teambudget passen. Sobald eines davon ausgeschöpft ist, wird die Anfrage gestoppt.

Gemeinsam genutzter Produktions-Traffic muss deshalb bewusst zugeordnet werden. Erstellt ein Teammitglied einen neuen Key für eine Anwendung mit Kundenverkehr, wird dieser Key standardmäßig der betreffenden Person zugeordnet. Deren persönlicher Ausgabenrahmen kann dann die Anwendung stoppen. Auf der Seite mit den AI Gateway API Keys sollte die Spend attribution des Keys auf Team gesetzt werden, damit nur dessen Key- und Teambudget greifen.

Die betriebswirtschaftliche Rechnung hat sich verändert

Limits pro Nutzer machen aus einem gemeinsamen Risiko einen Ausgabenrahmen, der sich schon vor Eingang der Rechnung zuweisen lässt.

Als Beispiel dient eine Annahme, kein Vercel-Preis: Ein Team mit 8 Personen verfügt über ein monatliches Teambudget von $1,000. Sieben Mitglieder erhalten einen monatlichen Standardbetrag von $50. Eine leitende Person bekommt ein individuelles Budget von $150, weil diese Rolle umfangreichere Agenten-Workloads ausführt.

Der Gesamtrahmen für personengebundene Keys beträgt:

7 × $50 + 1 × $150 = $500 per month

Diese $500 kommen nicht zusätzlich zum Teambudget hinzu, sondern liegen innerhalb dieses Budgets. Wenn die mitgliedsbezogenen Keys zuerst ihre vollen $500 verbrauchen, werden dieselben $500 auch auf das Teamlimit von $1,000 angerechnet. In diesem vereinfachten Fall bleiben vor Erreichen des Teamlimits noch $500 für Produktionsverkehr mit teambezogenen Keys.

Reserviert wird davon allerdings nichts. Die Produktion kann zuerst Ausgaben verursachen, und jede Anfrage benötigt weiterhin Spielraum unterhalb des Teamlimits. Der Vorteil ist enger gefasst: Kein einzelnes Teammitglied kann über zugeordnete Keys mehr als den eigenen Rahmen verbrauchen, bevor alle anderen den Zugriff verlieren.

Das unterscheidet sich von der nativen Steuerung bei OpenAI, wo ein Agent ein eigenes Projekt benötigt, um eine durchgesetzte Projektobergrenze zu erhalten. Der Leitfaden zu Ausgabenlimits in der OpenAI API erläutert dieses Isolationsmodell. Die Nutzerebene von Vercel kann mehrere einem Mitglied zugeordnete Keys abdecken, ohne für jede Person ein eigenes Projekt anzulegen.

Das Feature senkt keine Token-Preise. AI Gateway berechnet weiterhin die Listenpreise der Anbieter, ohne Token-Aufschlag oder Plattformgebühr. Der Gewinn liegt in der Schadensbegrenzung und einer klareren Zuordnung, nicht in günstigerer Inferenz.

Vier Teams, deren Arbeitsablauf sich wirklich ändert

Produktentwicklung mit mehreren Coding-Agenten

Für das Team wird ein Standard-Nutzerbudget festgelegt; Personen mit höherem Bedarf erhalten einen individuellen Betrag. Verschiedene Agenten können mit getrennten Keys laufen, während alle Ausgaben dieser Keys weiterhin in einer einzigen persönlichen Obergrenze zusammenfließen.

Der Vorteil: Nächtliche Agentenschleifen bleiben finanziell begrenzt. Wiederholt ein Agent eine fehlgeschlagene Aufgabe immer wieder, werden die Anfragen der betreffenden Person gestoppt, ohne automatisch einen dem Team zugeordneten Produktionsdienst stillzulegen.

Agenturbetrieb mit geschützter Kundenmarge

Jede zuständige Person erhält einen mitgliedsbezogenen Key und einen Standardrahmen. Für jemanden, der eine modellintensive Migration oder einen kurzen Kundensprint betreut, lässt sich ein individuelles Budget ergänzen.

Der Vorteil ist eine klar benannte Ausnahme. Höhere Ausgaben können für eine Person freigegeben werden, ohne den Rahmen aller Teammitglieder anzuheben oder das gesamte Agenturbudget zum einzigen Schutzschalter zu machen.

Plattformverantwortung mit klarer Trennung von Personen und Produktion

Alle AI Gateway Keys werden geprüft und gemeinsam genutzte Dienste als Team markiert. Persönliche Keys für Coding-Agenten bleiben ihren jeweiligen Erstellern zugeordnet.

Der Vorteil ist eine saubere Fehlerisolation. Ein ausgeschöpfter persönlicher Rahmen stoppt den Agentenverkehr dieser Person, während ein kundenorientierter Workload weiterläuft, bis sein eigenes Key-Budget oder das Teambudget verbraucht ist.

Finanz- oder Betriebsverantwortung für die Richtlinie

Ein Owner kann die Berechtigung AI Gateway Budget Manager vergeben, ohne die vollständige Owner-Rolle zu übertragen. Diese Person kann Nutzerbudgets, Standardwerte und Key-Zuordnungen verwalten. Gleichzeitig können alle Teamrollen mit Ausnahme von Contributor die Budgetseiten einsehen.

Der Vorteil ist eine echte operative Zuständigkeit. Das Finanzteam kann den Rahmen festlegen, die Entwicklung sieht ihn, und eine Budgetänderung muss nicht auf die einzige Person warten, der das gesamte Vercel-Team gehört.

Vercel AI Gateway Budget einrichten, ohne die Produktion an eine Person zu binden

Für Nutzerbudgets setzt Vercel die CLI-Version 59.6.2 oder neuer voraus. Die folgenden Befehle wurden in diesem Durchlauf mit Version 59.6.2 geprüft.

1. 1

   CLI aktualisieren und Version prüfen

   Zuerst wird das dokumentierte Upgrade ausgeführt. Anschließend ist zu prüfen, ob mindestens Version 59.6.2 installiert ist.

   vercel upgrade
   vercel --version

2. 2

   Standardrahmen festlegen

   Dieses Beispiel gibt jedem Mitglied ohne individuelles Nutzerbudget einen eigenen monatlichen Rahmen von $50. Es handelt sich nicht um gemeinsam genutzte $50 für die gesamte Gruppe.

   vercel ai-gateway budgets defaults set user --limit 50 --refresh-period monthly

3. 3

   Für hohe Nutzung ein individuelles Limit setzen

   Ein individuelles Budget ersetzt den Standardwert für diese Person. Vercel akzeptiert eine E-Mail-Adresse, einen Benutzernamen oder eine Nutzer-ID.

   vercel ai-gateway budgets set user lead@example.com --limit 150 --refresh-period monthly
   vercel ai-gateway budgets list

4. 4

   Gemeinsam genutzte Keys dem Team zuordnen

   In AI Gateway wird unter API Keys jeder Key für kundenorientierte oder gemeinsam genutzte Workloads bearbeitet und seine Spend attribution auf Team gesetzt. Neue Keys sind standardmäßig User zugeordnet; diese Prüfung sollte deshalb zur Erstellung jedes Produktions-Keys gehören.

5. 5

   Warnungen dort aktivieren, wo Menschen reagieren müssen

   Individuelle Budgets können bei 50%, 75% und 100% des Limits E-Mails senden. Warnungen sind standardmäßig deaktiviert, und ein Standardbudget versendet keine Warnungen. Wenn eine bestimmte Person vor dem Stopp benachrichtigt werden soll, ist daher ein individuelles Budget nötig.

Monatliche Budgets werden am ersten Tag des Monats um Mitternacht UTC zurückgesetzt. Tägliche Budgets beginnen um Mitternacht UTC neu, wöchentliche Budgets montags um Mitternacht UTC. Mit none entsteht ein kumulatives Limit, das nie zurückgesetzt wird.

Stopp und Wiederanlauf in der Staging-Umgebung testen

Für diesen Artikel wurde kein Budget eines aktiven Vercel-Teams geändert, da für den Durchlauf kein entbehrliches Team mit passendem Key verfügbar war. Der sichere Test gehört deshalb in eine Staging-Umgebung. Das nachfolgend beschriebene 402-Verhalten und die Ausbreitungszeiten sind die von Vercel dokumentierte Zusage, kein in diesem Durchlauf gemessener Benchmark auf Kontoebene.

Für den Test werden ein eigenes Staging-Mitglied und ein dieser Person zugeordneter Key verwendet. Dieser Ablauf darf nicht mit einem Produktions-Key durchgeführt werden.

1. 1

   Mit sichtbaren Ausgaben beginnen

   Mit vercel ai-gateway budgets list lässt sich der bisherige Verbrauch des Staging-Mitglieds im aktuellen Zeitraum prüfen. Liegt er bereits über dem dokumentierten Mindestbetrag von $1, kann die Grenze ausgelöst werden, ohne einen weiteren Dollar an Testverkehr zu erzeugen.

2. 2

   Limit des Staging-Nutzers senken

   Beim Bearbeiten eines Budgets bleiben die im aktuellen Zeitraum bereits angefallenen Ausgaben erhalten. Das Limit des Staging-Nutzers wird auf $1 gesetzt; anschließend ist die Ausbreitungszeit abzuwarten.

   vercel ai-gateway budgets set user staging@example.com --limit 1 --refresh-period monthly

3. 3

   Eine Anfrage über den Key dieses Mitglieds senden

   Der mitgliedsbezogene Staging-Key wird als AI_GATEWAY_API_KEY exportiert. Danach kommt das von Vercel dokumentierte Format für eine direkte HTTP-Anfrage zum Einsatz.

   curl https://ai-gateway.vercel.sh/v1/chat/completions \
     -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "openai/gpt-5.6-sol",
       "messages": [
         {
           "role": "user",
           "content": "Invent a new holiday and describe its traditions."
         }
       ]
     }'

   Sobald das Nutzerbudget aktiv und ausgeschöpft ist, sollte die Anfrage HTTP 402 mit dem Fehlertyp quota_for_entity_exceeded zurückgeben. Weist die 402 einen anderen Fehlertyp aus, kann statt eines Budgets auch das Guthaben des Teams die Ursache sein.

4. 4

   Limit anheben und Anfrage wiederholen

   Das individuelle Limit wird über den von budgets list angezeigten Verbrauch angehoben. Der folgende dokumentierte Befehl verwendet $100.

   vercel ai-gateway budgets set user staging@example.com --limit 100 --refresh-period monthly

   Budgetänderungen werden meist nach einigen Dutzend Sekunden wirksam, können bei einem aktiven Key aber bis zu etwa fünf Minuten benötigen. Nach dieser Wartezeit wird dieselbe Anfrage erneut gesendet. Sie sollte wieder funktionieren, sofern nicht ein anderes zutreffendes Key- oder Teambudget ausgeschöpft ist.

5. 5

   Vorgesehene Richtlinie wiederherstellen

   Für den Staging-Nutzer wird wieder das geplante individuelle Limit gesetzt. Das Entfernen des individuellen Budgets ist nicht immer ein Ausweg, denn bei vorhandenem Standardwert fällt der Nutzer darauf zurück. Ist auch dieser Standard bereits ausgeschöpft, bleibt der Datenverkehr blockiert.

Zwei leicht zu übersehende Grenzen

Erstens liegen BYOK-Ausgaben außerhalb sämtlicher AI Gateway Budgets. Nutzt das Gateway eigene Zugangsdaten für einen Anbieter, werden diese Ausgaben separat erfasst und lassen sich durch ein Nutzerlimit nicht begrenzen. Eine fehlgeschlagene BYOK-Anfrage kann außerdem auf Vercel-Systemzugangsdaten zurückfallen und das AI Gateway Guthaben des Teams belasten.

Zweitens widersprechen sich die eigenen Seiten von Vercel derzeit beim Thema App-Tokens. Laut der Veröffentlichung vom 31. August decken Nutzerlimits neben zugeordneten API-Keys auch App-Tokens ab. Die aktuelle Dokumentation zu Budgets besagt dagegen, dass App-Tokens keinem Mitglied zugeordnet sind und nie auf ein Nutzerbudget angerechnet werden.

Was am Montag zu tun ist

Handlungsbedarf besteht noch in dieser Woche, wenn mehrere Teammitglieder Coding-Agenten oder andere unbeaufsichtigte Workloads über ihre eigenen AI Gateway Keys ausführen. Wenn der Datenverkehr ausschließlich Projekt-OIDC-Tokens oder BYOK-Zugangsdaten der Anbieter nutzt, kann gewartet werden, da Nutzerbudgets diese Pfade nicht kontrollieren. Für eine allein arbeitende Person mit einem Key und einem Teambudget ändert sich kaum etwas.

Am Montag wird jeder Gateway-Key als PERSON oder SHARED klassifiziert. Zuerst werden gemeinsam genutzte Produktions-Keys auf die Team-Zuordnung umgestellt. Danach folgen ein monatliches Standard-Nutzerbudget, ausschließlich geschäftlich nachvollziehbare Ausnahmen und der vollständige 402-Test in der Staging-Umgebung: stoppen, anheben, wieder anlaufen lassen. Die Budgetregelung ist erst dann einsatzbereit, wenn die Produktion außerhalb des Budgets einer einzelnen Person bleibt und die zuständige Person weiß, welches Limit eine Anfrage blockiert hat.

Weitere Praxishinweise zu KI-Kostenkontrolle und Produktionsabläufen gibt es im Newsletter.