Jeder API-Schlüssel und jede Assistenten-Verbindung hat ein tägliches Ausgabenlimit in Credits. Für eine neue Verbindung liegt es standardmäßig bei 5.000 Credits.

Zwei weitere Limits kannst du einem Schlüssel oder einer Verbindung geben:

  • ein monatliches Limit, über den Kalendermonat (UTC);
  • ein Limit pro Frage, das meiste, was eine einzelne Frage kosten darf.

Was am Limit passiert

Eine Frage, die die Verbindung über eines ihrer Limits bringen würde, wird abgelehnt: Die API antwortet mit 402 und spend_cap_reached (der MCP-Server meldet es als spend_cap_exceeded). Die Fehlermeldung sagt, wie viel übrig ist und, bei Tages- und Monatslimit, wann es zurückgesetzt wird. Es wird nichts ausgegeben. Ergebnisse lesen funktioniert weiter. Eine abgebrochene oder erstattete Frage schreibt ihre Credits dem Limit wieder gut.

Prüfen, was übrig ist

Die Guthabenabfrage deines Assistenten und GET /v1/billing/balance liefern capRemaining für den Schlüssel oder die Verbindung, die du nutzt: das Kleinere aus dem, was heute und diesen Monat noch übrig ist. Ein gut gebauter Agent prüft vor dem Fragen, aber das Limit greift, ob er prüft oder nicht. GET /v1/connections/current zeigt die Limits der Verbindung und was sie heute und diesen Monat ausgegeben hat.

Ein Limit ändern

Öffne unter Entwickler bei einem Schlüssel Berechtigungen und Limits oder bei einer Verbindung Limits und Berechtigungen und setz neue Limits. Die Änderung wirkt sofort.

In einem Team kann der Inhaber oder ein Admin das Limit eines Schlüssels oder einer App ändern, die ein anderes Mitglied erstellt hat. Öffne Schlüssel und Apps unter Team oder, für eine Zapier-Verbindung, Einstellungen, dann Integrationen. Siehe Dein Team.

Alte Schlüssel aus der Zeit vor den Limits haben keins. Sie stehen in Entwickler unter Alte Schlüssel, damit du sie widerrufen kannst, und wir stellen sie nach 90 Tagen Ankündigung ein. Erstell stattdessen einen neuen Schlüssel mit Limit.

Warnungen

Unter Entwickler, Warnungen, wählst du, welche dieser E-Mails du möchtest. Sie gehen an die E-Mail-Adresse deines Kontos, und jede enthält einen Abmeldelink, der genau diese Warnung ausschaltet.

  • Eine Verbindung erreicht 80 % ihres Tageslimits (oder ihres Monatslimits, falls sie eins hat).
  • Fehler häufen sich: Eine Verbindung hatte gestern mindestens 50 Aufrufe, und mehr als ein Fünftel davon schlug fehl.
  • Ein neuer Agent verbindet sich.

Die Warnungen findest du unter Entwickler, nicht unter Einstellungen, dann E-Mails.

Kontolimits

Schlüssel-Limits liegen innerhalb der Limits deines Kontos: Ein Agent kann nie mehr ausgeben als dein Guthaben. Bei einem Schlüssel oder einer Verbindung, die für ein Team erstellt wurde, geben die Fragen die Credits des Teams aus, und das Monatslimit des Mitglieds im Team gilt zusätzlich.