Dokumentation

Credits & Metering

Das Credit-System verstehen, den Verbrauch nachverfolgen und Budget-Warnungen konfigurieren.

betool rechnet nutzungsbasiert in Credits ab: 1 Credit = 0,0001 € (ein Zehntausendstel Euro). Sie laden Ihr Guthaben im Voraus auf; jede Ausführung bucht die entsprechenden Kosten ab.

Warum Credits

Das Credit-System ermöglicht:

  • Feine Granularität — ein API-Aufruf zu $0.000003 ist ohne Rundung messbar.
  • Preisstabilität — Ihre Stückpreise in Credits ändern sich nicht, wenn ein Anbieter seine Tarife anpasst.
  • Aufteilung pro Organisation — jede Org hat ihr eigenes Guthaben und ihre eigenen Warnungen.

Was wird bezahlt?

Die Details finden Sie unter Preise. Zusammenfassung:

  • LLM — bei einem managed Modell pro Input-/Output-Token. Bei BYOK nichts: Sie zahlen Ihren Anbieter direkt, betool nimmt nichts auf die Tokens.
  • Sprache — ASR pro Sekunde, TTS pro Zeichen.
  • Telefonie — an sich kein Minutenpreis: Ein Anruf wird nach seinen Bestandteilen abgerechnet (Transkription, Sprachsynthese, LLM).
  • HTTP-/DB-/Transform-Operatoren — nicht abgerechnet.

Ihr Guthaben aufladen

Zwei Modi:

  • Manuell — unter Organisationseinstellungen → Plan (Schaltfläche Aufladen) einen einmaligen Betrag hinzufügen.
  • Automatisches Aufladen — automatisches Nachladen, wenn das Guthaben unter einen Schwellenwert fällt. Empfohlen, um Unterbrechungen zu vermeiden.

Den Verbrauch verfolgen

Organisationseinstellungen → Nutzung:

  • Aktuelles Guthaben
  • Verbrauchsverlauf, filterbar nach Zeitraum
  • Aufschlüsselung nach Pipeline-Knoten und nach Ressourcentyp

Die Tabelle ist als Excel exportierbar, zur Integration in Ihr internes Controlling.

Warnungen

Zwei automatische Warnungen schützen Ihr Guthaben:

  • Niedriges Guthaben — wenn das Guthaben unter einen Schwellenwert fällt, werden die Administratoren der Org benachrichtigt (In-App + E-Mail).
  • Guthaben aufgebraucht — wenn das Guthaben auf null fällt, wird sofort eine eigene Warnung versendet.

Kombinieren Sie sie mit dem automatischen Aufladen (Schwellenwert + Betrag, je Organisation konfigurierbar), um die Unterbrechung nie zu erreichen.

Ablehnung vor dem Aufruf

Reicht Ihr Guthaben nicht aus, um einen LLM-Aufruf oder einen Telefonanruf auszuführen, lehnt betool die Ausführung vor jeder Abbuchung ab, mit einem expliziten Fehler out of credits, der im Verlauf sichtbar ist.

Keine Überberechnung möglich: Ein Aufruf startet nie ohne verfügbares Guthaben.

Dateispeicher

Ihr Plan kann einen erlaubten Speicher festlegen: das Volumen an Dateien, das Ihre Organisation in betool aufbewahrt — Dateien der Wissensdatenbank, empfangene Anhänge, von Ihren Prozessen erzeugte Dateien. Ein Plan ohne Begrenzung zeigt Unbegrenzter Speicher an.

Die Nutzung verfolgen Sie unter Organisationseinstellungen → Plan, Abschnitt Speicher: belegtes Volumen, verbrauchter Anteil des Plans und eine Anzeige, die das Überschreiten von 80 % und dann den vollen Speicher signalisiert.

Die Grenze wird bei jedem Schreiben einer Datei geprüft, vor der Übertragung in den Speicher:

  • Von Ihrer Organisation veranlasste Schreibvorgänge — Import in die Wissensdatenbank, von einem Knoten erzeugte Dateien (Download, Entpacken eines Archivs, Aufteilen einer PDF, Excel-Export …): Oberhalb der Grenze wird der Schreibvorgang abgelehnt und nichts geschrieben. Der betroffene Knoten nimmt seinen Fehlerpfad; ein Knoten, der mehrere Dateien erzeugt, entfernt die bereits geschriebenen.
  • Von Ihren Kontakten gesendete Dateien — E-Mail-Anhänge, Medien aus Messengern, per Webhook empfangene Dateien: immer angenommen, auch oberhalb der Grenze (die Nachricht eines Kunden geht nie verloren), und auf Ihre Nutzung angerechnet.

Um wieder Spielraum zu gewinnen: Löschen Sie Dateien (das Löschen eines Dokuments aus der Wissensdatenbank löscht seine Datei) oder wechseln Sie zu einem höheren Plan.

Für Entwickler

Wenn Sie die Admin-API aufrufen, liefert der Endpunkt GET /api/admin/billing/state Ihren Plan, Ihr Guthaben und den Status des automatischen Aufladens; GET /api/admin/billing/storage-usage liefert Ihre Speichernutzung und deren Grenze. Ein wegen vollen Speichers abgelehnter Schreibvorgang antwortet mit 507 Insufficient Storage.