Beta

Credits und Wiederholungen

Ihre Organisation zahlt jede Antwort in einem Abrechnungszeitraum nur einmal. Diese Seite sagt, was als dieselbe Antwort gilt, was API und MCP Ihnen darüber melden und wann ein Aufruf nichts kostet.

Die Regel

Innerhalb eines Abrechnungszeitraums zahlt Ihre Organisation jede Antwort nur einmal, in der Web-App, der API und über MCP gleichermaßen. Eine Suche sind die eingegebenen Wörter. Blättern, Sortieren und Filter auf denselben Wörtern sind inklusive. Eine Entscheidung ist die Entscheidung, eine Vorschrift ist die Vorschrift, und das Verweisnetz einer Entscheidung ist eine Antwort.

Die Regel gilt für die ganze Organisation, nicht für einen Nutzer oder ein Token. Ein Kollege, ein anderes API-Token oder eine andere MCP-Verbindung liest dieselbe Antwort für 0 Credits.

Sieben Ausnahmen folgen in der Tabelle und in den Beispielen. Die Preisseite nennt sie in einfachen Worten.

So rechnen wir ab, in einfachen Worten, auf der Preisseite

Was als dieselbe Antwort gilt

Jede Zeile nennt eine Antwort, woran ein zweiter Aufruf als dieselbe Antwort gilt und woran als neue.

AntwortDieselbe AntwortEine neue Antwort
SucheDieselben Wörter, auf jeder Oberfläche und in beiden Such-Werkzeugen (search_decisions und cross_type_search). Blättern, limit, Sortierung, Filter und Modus auf denselben Wörtern sind inklusive, bis zu 20 verschiedene Kombinationen je Abrechnungszeitraum. Der erste Aufruf ist eine davon.Andere Wörter. Die Kombination nach den 20 enthaltenen wird als neue Suche berechnet, mit eigenen 20. Füllwörter allein (etwa „und“, „der“ oder „Urteil“) gelten nach ihren Filtern, jede Filterkombination ist dann eine neue Suche. Eine Suche ohne Treffer ist kostenlos.
EntscheidungDieselbe Entscheidung über jede Kennung (ECLI, Aktenzeichen oder UUID), in jedem Abschnitt oder Randnummernbereich, in der Web-App, der API oder über MCP.Eine andere Entscheidung.
Vorschrift (§)Derselbe § oder Artikel, mit jedem Absatz, über MCP (get_norm) oder REST.Eine andere Vorschrift. Die Seite des ganzen Gesetzes in der Web-App ist eine eigene Antwort.
GesetzesseiteDie Seite desselben ganzen Gesetzes in der Web-App.Eine Vorschrift dieses Gesetzes. Die Seite deckt ihre Vorschriften nicht ab, und eine Vorschrift deckt die Seite nicht ab.
Verweisnetz einer EntscheidungDas Verweisnetz derselben Entscheidung, gleich welche Tiefe, Richtung oder Seite, auf jeder Oberfläche. Ein Export des Verweisnetzes berechnet nur die Entscheidungen, deren Verweisnetz noch nicht enthalten ist.Das Verweisnetz einer anderen Entscheidung.
DatenpaketDieselbe Auswahl von Entscheidungen mit denselben Optionen (include_citations, full_text, max_chars). Nach einem full_text-Datenpaket ist das einzelne Lesen jeder Entscheidung inklusive, die es vollständig geliefert hat. Ein durch max_chars gekürzter Text gilt nicht als vollständig gelesen.Eine andere Auswahl oder andere Optionen: 1 Credit je Entscheidung, höchstens 5 Credits. Früher geöffnete Entscheidungen werden nicht abgezogen.
Citation CheckDerselbe Text. Leerzeichen und Zeilenumbrüche werden zuvor vereinheitlicht.Ein geänderter Text wird vollständig geprüft und nach seiner Länge erneut berechnet.

Der credits-Block

Jede berechnete Antwort der REST-API und von MCP trägt einen credits-Block. Er zeigt, was der Aufruf gekostet hat und ob die Antwort schon enthalten war.

FeldBedeutung
meteredtrue, wenn der Aufruf überhaupt berechnet wird. Kostenlose Werkzeuge melden false.
costDie Credits, die dieser Aufruf gekostet hat. 0 bei einer Wiederholung.
credits_remainingDie Paket-Credits, die nach dem Aufruf übrig sind.
includedtrue, wenn Ihre Organisation diese Antwort im Abrechnungszeitraum schon bezahlt hatte.
covered_byDie Operation, die sie bezahlt hat: search.semantic, document.unlock, graph.traverse, norm.lookup, export.bulk oder citation.check. null, wenn die Antwort nicht enthalten ist. Das Feld nennt nie einen Nutzer, ein Token oder eine Oberfläche.
refinements_leftNur bei einer Suche: wie viele neue Kombinationen aus Filtern, Sortierung und Modus noch inklusive sind.
Eine wiederholte Suche, die schon bezahlt war
{
  "credits": {
    "metered": true,
    "cost": 0,
    "credits_remaining": 412,
    "included": true,
    "covered_by": "search.semantic",
    "refinements_left": 17
  }
}

Der Antwort-Header

Antworten der REST-API und der Web-App tragen den Header X-Klaracase-Credits. Sein Wert lautet charged=<n>; included=<true|false>. charged sind die Credits, die dieser Aufruf gekostet hat. included ist true, wenn Ihre Organisation die Antwort schon bezahlt hatte. Über MCP lesen Sie den credits-Block des Ergebnisses: Er trägt dieselben Angaben.

Eine Wiederholung, wie der Header sie zeigt
X-Klaracase-Credits: charged=0; included=true

Was als Fehler zählt

Nur eine ausgelieferte Antwort wird berechnet. Diese Status berechnen nichts: 403, 404, 429, jeder 5xx und Validierungsfehler (422). Eine Ablehnung wegen fehlender Credits (402) ist nicht gelaufen. Ein MCP-Tool-Fehler berechnet ebenfalls nichts.

Ein Absturz, ein Timeout oder ein gestoppter Worker berechnet nichts, weil die Berechnung nach der Antwort kommt. Scheitert ein Aufruf bei uns und Sie senden ihn erneut, zahlen Sie einmal, wenn der zweite Versuch klappt.

Ein Fall läuft nach der Antwort. Ein Citation Check in der Web-App wird berechnet, sobald wir ihn annehmen, und vollständig erstattet, wenn der Lauf scheitert.

Der Abrechnungszeitraum je Paket

Eine Wiederholung ist innerhalb eines Abrechnungszeitraums kostenlos. Für Free- und Tester-Organisationen ist der Abrechnungszeitraum der Kalendermonat (UTC). Bei einem bezahlten Paket ist es der Abrechnungszeitraum, der mit einer bezahlten Rechnung beginnt.

Eine normale Verlängerung beginnt eine neue Zählung: Was Sie im neuen Zeitraum erneut öffnen, wird erneut berechnet. Ein Upgrade, ein Downgrade oder ein neuer Abrechnungstag tut das nicht. Eine Antwort, die in einem früheren, sich überschneidenden Zeitraum bezahlt wurde, bleibt enthalten.

Zahlen und Limits

20 verschiedene Kombinationen aus Filtern, Sortierung und Modus sind je Suche und Abrechnungszeitraum inklusive. Blättern zählt nie. Wir veröffentlichen diese Zahl und prüfen sie an der gemessenen Nutzung. Eine Änderung kündigen wir im Änderungsprotokoll an und nehmen sie nie stillschweigend vor.

Ein Admin der Organisation kann für jedes API-Token und jede MCP-Verbindung ein Credit-Limit setzen. Ein Limit zählt die Credits, die ein Aufruf kostet. Eine enthaltene Antwort verbraucht es daher nicht.

Durchgerechnete Beispiele

Es gelten die aktuellen Preise: eine Suche 1 Credit, eine Entscheidung 1 Credit, eine Vorschrift 1 Credit, ein Verweisnetz 2 Credits.

  1. Dieselbe Suche im Web, dann über MCP

    Ein Kollege sucht „Mietminderung Schimmel“ in der Web-App. Das kostet 1 Credit. Später ruft ein Agent search_decisions mit denselben Wörtern auf und ergänzt einen Gerichtsfilter. Der credits-Block zeigt cost 0, included true, covered_by search.semantic und refinements_left 18. Es wird nichts berechnet, denn die Wörter sind dieselben.

  2. Drei Filteränderungen, dann Seite 2

    Sie suchen „Kündigung Eigenbedarf“ und zahlen 1 Credit, es bleiben 19 Kombinationen. Sie grenzen nach Gericht ein, dann nach Jahr und sortieren nach Datum. Das sind drei weitere Kombinationen, es bleiben 16. Sie öffnen Seite 2 der letzten Ansicht. Blättern zählt nie, also ändert sich nichts. Insgesamt zahlen Sie 1 Credit.

  3. Die 21. Verfeinerung

    Nach 20 verschiedenen Kombinationen auf denselben Wörtern wird die nächste neue Kombination als neue Suche berechnet. Sie kostet 1 Credit und beginnt eine neue Zählung, mit 19 übrig. Die schon genutzten Kombinationen bleiben bei Wiederholung kostenlos.

  4. Ein Volltext-Datenpaket mit 3, dann eine davon lesen

    Sie stellen ein Datenpaket mit 3 Entscheidungen und full_text zusammen. Es kostet 3 Credits. Danach lesen Sie eine davon mit get_decision: cost 0, included true. Eine Entscheidung, die nicht im Paket war, kostet 1 Credit. Stellen Sie dasselbe Datenpaket im Abrechnungszeitraum erneut zusammen, kostet es nichts.

  5. Eine Free-Organisation wechselt mitten im Monat

    Eine Free-Organisation öffnet am 3. eine Entscheidung und zahlt 1 Credit. Am 15. wechselt sie in ein bezahltes Paket, das einen neuen Abrechnungszeitraum beginnt. Dieselbe Entscheidung am 20. zu öffnen, kostet nichts, denn der neue Zeitraum überschneidet sich mit dem alten. Verlängert sich das bezahlte Paket, beginnt der neue Zeitraum eine neue Zählung, und sie erneut zu öffnen kostet 1 Credit.

  6. Ein Serverfehler, dann ein neuer Versuch

    Sie lesen eine Entscheidung, und der Aufruf scheitert mit einem 500. Es wird kein Credit abgebucht. Sie senden ihn erneut, und er klappt: Er kostet 1 Credit, einmal. Ein drittes Lesen im selben Abrechnungszeitraum kostet nichts.