Dokumentation durchsuchen
Plans & credits

Credits & Messung

Wie das Credit-Ledger funktioniert, die zwei Schutzmechanismen gegen ein Überziehen, und warum Ihr Verlängerungsdatum nicht der Erste des Monats ist.

BoostEcom ist eine monatliche Pauschalgebühr, die Credits enthält. Es gibt keine Token-Rechnung, die man am Monatsende entschlüsseln muss.

Die Beträge pro Stufe befinden sich in Pläne & Limits — bewusst an nur einem Ort, damit sie sich nie widersprechen können.

Das Ledger

Credits sind ein Nur-Anhängen-Ledger, kein Zähler, der überschrieben wird. Jede Gewährung und jeder Verbrauch ist eine Zeile. Ihr Guthaben ist die Summe, was bedeutet:

  • Die Historie ist auditierbar: Sie können immer sehen, was was verbraucht hat.
  • Ein Bug kann eine korrigierende Zeile hinzufügen, nie still die Vergangenheit umschreiben.
  • GET /api/usage liest das Live-Ledger, keine zwischengespeicherte Zahl.

Aufschlag

Die Modellnutzung wird auf den kostenpflichtigen Stufen zum 1,5- fachen der zugrunde liegenden Anbieterkosten berechnet, und zum 1,0-fachen bei Custom. Dieser Multiplikator ist die Marge und wird angegeben, statt in einer undurchsichtigen „Credit"-Einheit versteckt zu werden.

Die zwei Schutzmechanismen

Beide sind hart und gelten für jeden Plan und jede Autonomiestufe:

1. Schätzung vor dem Streaming. Bevor eine Anfrage läuft, werden ihre Kosten geschätzt. Übersteigt die Schätzung Ihr Guthaben, wird die Anfrage mit 402 abgelehnt und nichts wird gestreamt. Sie werden nie für eine Anfrage belastet, die ohnehin ausgelaufen wäre.

2. Harte Obergrenze während des Streamings. Eine lange Generierung wird während des Laufs gemessen. In dem Moment, in dem die laufenden Kosten Ihr Guthaben erreichen, wird der Stream abgebrochen. Eine Anfrage kann nie in ein negatives Guthaben überziehen.

Die Verlängerung ist Ihr Jahrestag, nicht der 1.

Monatliche Credits setzen sich am Ankertag Ihres Abonnements zurück, dem Tag des Monats, an dem Sie abonniert haben, nicht am Ersten. Ein Store, der am 18. abonniert hat, aktualisiert sich am 18.

Der tägliche Cron durchläuft Organisationen, deren Ankertag heute ist. Jede Gewährung ist idempotent: der Cron, der subscription.created- Webhook und das invoice.paid-Sicherheitsnetz schreiben alle über denselben Schlüssel, sodass drei Wege zu den Credits desselben Monats sie dennoch nur einmal gewähren.

Täglicher Bonus

Kostenpflichtige Stufen sammeln zusätzlich zur monatlichen Zuteilung einen kleinen täglichen Bonus an. Er ist pro Organisation, und er verfällt um Mitternacht UTC ohne sich anzusammeln. Die Beträge stehen in Pläne & Limits.

Steuer

Stripe Tax ist beim Checkout aktiv (EU-USt und US-Sales-Tax). Wenn Sie Credits kaufen, liest die Gewährung den Betrag vor Steuern. Sie erhalten nie Credits für die gezahlte Steuer, und Sie werden dadurch auch nie benachteiligt.

Ihre Nutzung lesen

| Oberfläche | Was sie liefert | |---|---| | GET /api/usage | Das Live-Ledger Ihrer Organisation. | | /<org>/~/billing | Abonnementstatus, Rechnungen, Plan. | | /<org>/~/billing/activate | Nach dem Checkout: der tatsächliche Status jedes Webhooks, bevor die Kontrolle zurückgegeben wird. |

Der letzte Punkt lohnt sich zu kennen. Nach einem Checkout zeigt er, ob die Zahlung, das Abonnement, der Planwechsel und die Credit-Gewährung jeweils tatsächlich angekommen sind, statt einen Timer laufen zu lassen und zu hoffen.

Auf diesen Docs aufgebaut?

Schauen Sie im Forum vorbei, wenn etwas unklar oder falsch ist. Docs verbessern sich schneller, wenn Lesende die Lücken melden.

Forum öffnen