Pakete, Kontingente und Abrechnung

Unter Abrechnung auf app.xicbot.de/abrechnung sehen Sie, welches Paket Ihr Konto hat, wie viel vom Monatskontingent verbraucht ist und aus welchen Positionen eine Rechnung entsteht. Diese Seite beschreibt die drei Pakete Start, Pro und Individuell mit ihren Grenzen und Merkmalen, das Monatskontingent mit Warnschwelle und Drosselung und jedes Feld der Ansicht. Preise stehen nicht hier, sondern unter Preise.

Pakete und ihre Grenzen

Die Grenzen stehen in der Ansicht Abrechnung unter Grenzen des Pakets, mit denselben Namen wie in dieser Tabelle. Ist für ein Konto ein Paket hinterlegt, das der Dienst nicht kennt, gelten die Grenzen von Start; die Ansicht vermerkt das unter der Verbrauchsanzeige.

• Sitzplätze zählen die Personen im Konto und die offenen Einladungen zusammen. Eine Einladung belegt ihren Platz schon, bevor sie angenommen wird, siehe Team und Rollen.
• Assistenten und Wissensquellen zählen alle Einträge des Kontos, unabhängig von ihrem Zustand.
• Dokumente und Abschnitte entstehen erst, wenn eine Quelle eingelesen wird; wie viele es werden, hängt vom Umfang der Quelle ab. Mehr dazu unter Wissen.
• Einheiten je Monat ist das Monatskontingent, beschrieben unter Monatskontingent.
• Anfragen je Minute begrenzt Aufrufe des Chatfensters je Besucher, beschrieben unter Anfragen je Minute.

Wann eine Zahlgrenze greift

Die Grenzen für Sitzplätze, Assistenten, Wissensquellen, Dokumente und Abschnitte prüft der Dienst, bevor etwas entsteht. Erreicht ist eine Grenze, sobald der Bestand der Grenzzahl entspricht: Bei Start ist mit dem ersten Assistenten die Grenze von 1 erreicht, ein zweiter lässt sich nicht anlegen.

• Dokumente und Abschnitte entstehen erst beim Einlesen. Vor dem Anlegen einer Quelle und vor dem erneuten Einlesen wird deshalb geprüft, ob die Grenze schon erreicht ist. Nach dem Einlesen prüft der Dienst den neuen Bestand ein zweites Mal, bevor er gilt: Würde eine Aufnahme oder Auffrischung den Bestand an Dokumenten oder Abschnitten vergrößern und dabei über die Grenze heben, wird sie nicht übernommen, und der bisherige Stand der Quelle bleibt erhalten. Das gilt auch für die Auffrischung im Hintergrund.
• Einträge über einer Grenze bleiben erhalten, etwa nach dem Wechsel in ein kleineres Paket. Gesperrt ist nur das Anlegen.
• Platz schaffen Sie, indem Sie nicht mehr benötigte Wissensquellen (Rolle Bearbeiten) oder Assistenten (Rolle Verwaltung) löschen oder eine offene Einladung zurücknehmen (Rolle Verwaltung). Gelöschtes zählt nicht mehr mit; mit einer Wissensquelle verschwinden auch ihre Dokumente und Abschnitte.

Über die Schnittstelle antwortet der Dienst bei erreichter Grenze mit Status 402 und plan_limit_reached, dazu limit mit dem Namen der Grenze (etwa assistants oder seats), allowed, used, plan und plan_name. Lässt sich der Bestand nicht zählen, kommt 503 mit plan_limit_unmeasured. Dieselben Grenzen für Wissensquellen, Dokumente und Abschnitte prüft auch POST /api/v1/integration/knowledge/sources, das Anlegen einer Quelle mit einem API-Schlüssel.

Merkmale der Pakete

Neben den Zahlgrenzen schalten Merkmale ganze Bereiche frei. Welche Merkmale ein Konto hat, hängt allein an seinem Paket; die Rolle entscheidet zusätzlich, wer den Bereich bedienen darf.

Mehrsprachige Antworten hängen an keinem Merkmal und stehen in jedem Paket zur Verfügung, auch in Start. Es gibt dafür weder eine Grenze noch eine eigene Position je Sprache: Eine Antwort zählt mit ihren Einheiten gegen das Kontingent, gleich in welcher Sprache sie entsteht.

Monatskontingent

Das Kontingent unter Einheiten je Monat zählt Einheiten (Token): die, die an das Sprachmodell gehen, und die, die es zurückgibt. Gezählt wird je Konto und Kalendermonat, für alle Assistenten zusammen. Mit dem Ersten eines Monats beginnt ein neuer Zählstand; der Vormonat bleibt unter Verlauf stehen.

• Es zählen Antworten im Chatfenster Ihrer Website, im Probierdialog, in Läufen der Abnahme und über die Schnittstelle.
• Ein Lauf der Einrichtung zählt mit seinen Einheiten und als eine Antwort.
• Eine Frage unter Antwort prüfen auf der Seite Wissen zählt mit ihren Einheiten und als eine Antwort, wenn dabei ein Modell Einheiten verbraucht. Siehe Wissen.
• Nicht gezählt werden Nachrichten in einem Gespräch, das ein Mensch übernommen hat: Dort wird kein Modell gefragt.
• Nicht gezählt wird eine Antwort aus einem aktiven Frage-Antwort-Paar: Sie geht im Wortlaut hinaus, ohne dass ein Modell gefragt wird. Ist das Kontingent erschöpft, kommt allerdings auch auf eine solche Frage die Notfallantwort. Siehe Wissen.
• Ist als Kontingent 0 hinterlegt, gilt es von Anfang an als erschöpft.

Bevor eine Antwort entsteht, reserviert der Dienst 2.500 Einheiten, für einen Lauf der Einrichtung 12.000. Reserviert wird nur, solange der Verbrauch unter dem Kontingent liegt. Nach der Antwort ersetzt der tatsächliche Verbrauch die Reservierung; kommt keine Antwort zustande, wird sie wieder freigegeben. Bricht ein Lauf hart ab, bevor gebucht ist, bleibt die Reservierung im Verbrauch des Monats stehen. Solange eine Antwort läuft, ist ihre Reservierung im angezeigten Verbrauch enthalten. Weil erst nach der Antwort gebucht wird, kann der Verbrauch das Kontingent um die zuletzt gelaufenen Antworten überschreiten; der Überhang erscheint unter Positionen.

Warnschwelle und Drosselung

Die Warnschwelle liegt bei 80 % des Kontingents, auf ganze Einheiten aufgerundet: 400.000 bei Start, 2.400.000 bei Pro. Ab dort antwortet der Assistent weiter, aber gedrosselt. Die Drosselung beginnt schon mit der Antwort, deren Reservierung die Schwelle überschreitet, und endet mit dem Monatswechsel oder wenn ein höheres Kontingent den Verbrauch wieder unter die Schwelle bringt.

Beim Überschreiten der Warnschwelle entsteht eine Meldung für den Betrieb von XICBOT; solange der Verbrauch darüber bleibt, folgt keine weitere. Überspringt eine einzelne Buchung Schwelle und Kontingent zugleich, bleibt es bei der Meldung zum erschöpften Kontingent. Diese Meldungen gehen an den Betreiber, nicht an die Nutzer Ihres Kontos. Ihren Stand sehen Sie unter Abrechnung in den Hinweisen oben. Eine Nachricht an Sie selbst gibt es beim Erreichen des Kontingents über den Webhook Budget erschöpft, siehe Wenn das Kontingent erschöpft ist.

Wenn das Kontingent erschöpft ist

Erschöpft ist das Kontingent, sobald der Verbrauch es erreicht. Dann fragt der Dienst kein Modell mehr, und es wird nichts gebucht. Was stattdessen geschieht, hängt vom Weg ab:

Die Antwort der Schnittstelle sieht so aus; month ist der laufende Abrechnungsmonat, budget das Kontingent und used der Verbrauch:

{
  "error": "quota_exhausted",
  "scope": "month",
  "month": "2026-09",
  "budget": 500000,
  "used": 502140,
  "retry_after": 86400
}

Haben Sie unter Schnittstellen einen Webhook für das Ereignis Budget erschöpft (budget.exhausted) eingerichtet, erhalten Sie eine Nachricht mit month, budget und used, und zwar bei der Buchung, mit der der Verbrauch das Kontingent erreicht. Solange der Verbrauch darüber bleibt, folgt keine weitere. Webhooks gehören zu Schnittstellen und stehen damit nur im Paket Individuell bereit. Siehe API-Schlüssel und Webhooks.

Antworten entstehen wieder, sobald der nächste Monat beginnt oder das Kontingent so erhöht wird, dass es über dem Verbrauch liegt.

Anfragen je Minute

Anfragen je Minute begrenzt, wie oft ein einzelner Besucher das Chatfenster in einer Minute aufrufen kann, etwa um die Einstellungen oder den Verlauf zu laden. Gezählt wird je Besucher und zusätzlich je Gespräch; jeder der beiden Zähler kann abweisen. Für das Senden von Fragen gelten eigene Grenzen. Alle Werte und die Antwort bei Überschreitung stehen unter Widget-Auslieferung. API-Schlüssel haben einen eigenen Minutenwert je Schlüssel, siehe API-Grenzen.

Die Ansicht Abrechnung

Abrechnung steht in der Seitenleiste in der Gruppe Verwaltung, zusammen mit Team und Konto. Jede Rolle kann die Ansicht öffnen, sobald die E-Mail-Adresse bestätigt ist; bis dahin steht dort „Dieser Bereich bleibt gesperrt, bis die E-Mail-Adresse bestätigt ist.“ Die Seite trägt die Überschrift Verbrauch und Abrechnung und den Satz „Der Verbrauch des laufenden Monats, die Grenzen Ihres Pakets und die Positionen, aus denen eine Rechnung entsteht.“ Sie zeigt nur an; ändern lässt sich hier nichts. Unter Zahlung folgt der Abschnitt Paket wechseln: „In der App lässt sich das Paket nicht wechseln; wir stellen es für Ihr Konto um. Den Wechsel beauftragt, wer für das Konto zeichnet, per E-Mail an die Adresse unten. Nennen Sie darin den Kontonamen und das gewünschte Paket.“ Darunter stehen die Adresse mail@xicbot.de als Mailverweis mit dem Betreff „Paketwechsel“ und dem Namen des Kontos und der Verweis Was ein Wechsel ändert auf diese Seite. Der Abschnitt steht auch dann da, wenn die Übersicht nicht geladen werden konnte.

Hinweise oben

„Keine Antworten mehr“ meint Antworten des Modells. Was Besucher und die Schnittstelle stattdessen erhalten, steht unter Wenn das Kontingent erschöpft ist.

Verbrauch

• Darunter steht Paket mit dem Namen Ihres Pakets, Verbrauch und Kontingent (etwa 412.300 / 500.000) und ein Balken mit dem Anteil in ganzen Prozent, abgeschnitten, nicht gerundet, und höchstens 100. Der Balken wechselt ab der Warnschwelle die Farbe und wird rot, wenn das Kontingent erschöpft ist.
• Bei einem Kontingent über 0 steht unter dem Balken Warnschwelle mit der Zahl der Einheiten, ab der gedrosselt wird. Ist für Ihr Konto ein Paket hinterlegt, das der Dienst nicht kennt, steht darunter „Dieser Wert konnte nicht ermittelt werden und ist deshalb kein Ergebnis.“ mit dem hinterlegten Schlüssel in Klammern.
• Die Karte Warnschwelle listet je Größe den Stand, etwa „412.300 von 500.000 · 82% · Warnschwelle: 400.000“. Der Anteil wird hier wie am Balken und im Hinweis oben abgeschnitten, nicht gerundet. Die Zeile Abgerechnete Antworten zeigt Nicht gemessen mit dem Grund „Kein monatliches Kontingent an Antworten vereinbart. Der Verbrauch wird gezählt, nicht gegen eine Grenze gemessen.“, denn für Antworten gibt es keine Grenze.
• Ist als Kontingent 0 hinterlegt, zeigt die Zeile Abgerechnete Einheiten Nicht gemessen mit dem Grund „Kein Kontingent hinterlegt. Vor dem Anschlag gibt es nichts vorzuwarnen, der Anschlag ist bereits erreicht.“

Grenzen des Pakets

Die Tabelle Grenzen des Pakets hat die Spalten Name und Wert und listet die acht Grenzen aus Pakete und ihre Grenzen. Zahlen stehen mit Tausenderpunkt, Gespräche exportieren mit Ja oder Nein. Bei Einheiten je Monat und Anfragen je Minute stehen dort in jedem Paket die für Ihr Konto hinterlegten Werte.

Positionen

Über der Tabelle steht der Zeitraum vom ersten bis zum letzten Tag des Monats und die Preisbasis, etwa „Zeitraum: 1.9.2026 – 30.9.2026 · Beträge netto“. Die Tabelle hat die Spalten Position, Menge und Betrag.

• Summe addiert die Beträge. Fehlt bei einer Position der Betrag, steht dort Nicht gemessen und darunter „Es fehlt mindestens ein vereinbarter Preis. Die Summe wird deshalb nicht gebildet, statt eine zu erfinden.“ Das gilt für Individuell und für jeden Monat mit Einheiten über dem Kontingent.
• Unter Zahlung steht „Es ist kein Zahlungsanbieter angebunden. Die Abrechnung erfolgt außerhalb dieser Oberfläche.“ In der App wird nichts bezahlt und keine Rechnung ausgelöst.

Verlauf

Verlauf zeigt bis zu 24 Monate, den neuesten zuerst und den laufenden eingeschlossen, mit den Spalten Monat, Abgerechnete Einheiten und Abgerechnete Antworten. Ohne Verbrauch steht dort „Noch kein Verbrauch erfasst.“

Wenn eine Grenze nicht reicht

Das Paket lässt sich in der App nicht wechseln; es wird für Ihr Konto gesetzt. Für einen Wechsel schreiben Sie an mail@xicbot.de; den Mailverweis dafür finden Sie unter Abrechnung im Abschnitt Paket wechseln. Nach dem Wechsel gelten, wie im Hinweis zu den hinterlegten Werten beschrieben, die neuen Grenzen beim nächsten Anlegen und das neue Kontingent bei der nächsten Antwort. Der Verbrauch des laufenden Monats zählt weiter; ein erschöpftes Kontingent gibt wieder Antworten frei, sobald das neue Kontingent über dem Verbrauch liegt.

Schnittstelle

Außer 402 für ein fehlendes Merkmal oder eine erreichte Grenze kennt die Paketprüfung zwei weitere Antworten. Gehört die Anfrage zu keinem Konto, antwortet sie mit 403 und no_tenant. Prüft ein Weg ein Merkmal oder eine Grenze, die kein Paket kennt, antwortet sie mit 500 und plan_gate_misconfigured, dazu feature, limit oder kind mit dem betroffenen Namen. Das ist ein Fehler auf Seiten von XICBOT. In beiden Fällen wird die Anfrage nicht ausgeführt; melden Sie den zweiten Fall bitte an mail@xicbot.de.

Häufige Fragen