Zum Hauptinhalt springen
Lies und ändere monatliche Agent-Budgets in Euro. Nutze für diesen Workspace-Modus das Präfix ai-models-included. Die Aufrufe laufen über den BILLING_API Scope des Workspace-API-Schlüssels. Schreibzugriffe laufen als der Service Account, dem der Schlüssel gehört.
Diese Routen gelten, wenn GET /billing/v1/mode den Modus ai-models-included liefert. Ein Dedicated Deployment liefert immer bring-your-own-keys, auch wenn Langdock die Modellschlüssel verwaltet. Der andere Modus antwortet mit 409 und code BILLING_MODE_MISMATCH.

​
Basis-URL

​
Voraussetzungen

  • API-Schlüssel mit dem Scope BILLING_API
  • Der Besitzer ist ein Service Account, der nicht gelöscht ist und eine aktive Admin-Mitgliedschaft hat

​
Budget ändern

PATCH /agents/{agentId} akzeptiert budget, budgetMode oder beides. Schick mindestens eines.
budget ist ein monatlicher Betrag in Euro:
  • { "type": "limited", "amount": 40 } setzt eine Obergrenze. Der Betrag muss größer als null sein.
  • { "type": "unlimited" } behält ein eigenes Budget ohne Zahlenobergrenze. Die Ausgaben können trotzdem gemeldet werden. Das ist nicht dasselbe wie none.
  • { "type": "none" } entfernt das eigene Agent-Budget. Der Agent folgt dann den Limits von Workspace und Mitglied.
budgetMode legt fest, wann dieses Budget gilt:
  • always (Immer) zählt die Nutzung sofort gegen das Agent-Budget, auch API-Aufrufe, und verbraucht das Kontingent des Mitglieds nicht.
  • on_limit_hit (Nach Nutzerlimits) zählt die Nutzung zuerst gegen die Limits des Mitglieds. Erst wenn das Mitglied ein persönliches Limit erreicht, zählt die Nutzung gegen das Agent-Budget.
Das Budget wird nur durchgesetzt, solange die Extra-Nutzung an ist. Ist sie aus, bleibt das gespeicherte Budget erhalten, gilt aber nicht, und die Ausgaben bleiben bei null. Ein aktives Agent-Budget folgt weiterhin dem Extra-Nutzungslimit des Workspace aus Extra-Nutzung: Einstellungen abrufen. Das Budget zu entfernen schaltet dieses Limit nicht aus. Die Antwort ist das Agent-Objekt mit budgetPeriodSpend auf null. Lies den Agenten danach erneut, um die Ausgaben zu bekommen.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.