Wenn ein Agent Credits ausgeben will, die er nicht hat, antwortet die API mit HTTP 402, statt still zu scheitern oder leere Ergebnisse zu liefern. Die Antwort sagt, was fehlt, und enthält die URL, über die du es behebst.
Je nach Client zeigt sich derselbe Zustand unterschiedlich:
- REST-API: Status 402 mit einer Meldung und einem Link zum Aufladen oder zur Planwahl.
- CLI: Exit-Code 5, das heißt Zahlung erforderlich. Skripte und CI können direkt darauf verzweigen.
- MCP-Clients: Der Agent gibt die Meldung im Gespräch wieder, meist als "deine Credits sind aufgebraucht".
So geht es weiter:
- Öffne die Startseite und lade das Guthaben auf, oder wähl einen Plan unter Profil → Abrechnung.
- Die Credits werden gebucht, sobald die Zahlung abgeschlossen ist.
- Führ denselben Befehl erneut aus. Nichts muss neu eingerichtet werden, und die API-Keys bleiben die ganze Zeit gültig.
Ein 402 kann auch etwas anderes bedeuten als ein leeres Guthaben. Wenn die Meldung die Bestätigung deiner E-Mail erwähnt, warten die 25 Starter-Credits hinter der E-Mail-Bestätigung. Wenn sie erwähnt, dass die Starter-Credits für dieses Postfach schon eingelöst wurden, ist die einmalige Gutschrift verbraucht, und das Guthaben ist der nächste Schritt.
Kostenlose Aktionen werden nie durch einen 402 blockiert: Zählungen und geschwärzte Vorschauen funktionieren weiter, während du das Guthaben klärst.