Abrechnung und Credits
API-Version 2026-10-virile-dragon
Zwei Arten zu bezahlen
Ein Client wird auf eine von zwei Arten abgerechnet, und sein Modus wird beim Erstellen festgelegt. Ein allowance-Client verbraucht das Tarifkontingent seines Eigentümers, dasselbe Kontingent wie deine Apps, und belastet nie eine Karte. Ein metered-Client verbraucht kein Kontingent: Jeder seiner Aufrufe kostet Credits, die der Karte deines Abonnements mit Nutzungsabrechnung belastet werden. Ein Aufruf, den eine App mit einem Token aus einem Autorisierungscode für einen anderen Nutzer tätigt, verbraucht immer das Kontingent dieses Nutzers, unabhängig vom Modus des Clients.
Credits pro Aufruf
Ein Aufruf eines metered-Clients kostet so viele Credits, wie sein Scope wert ist; die Tabelle unten listet sie auf. Ein Scope mit 0 Credits kostet nichts. Die units, die GET /v1/usage meldet, lassen sich mit diesen Gewichten in Credits umrechnen. Ein Aufruf wird mit den Gewichten abgerechnet, die am Tag des Aufrufs gelten, unabhängig von der Version, an die der Client gebunden ist: Die Tabelle in der Referenz einer älteren Version hält die Gewichte zum Zeitpunkt ihrer Veröffentlichung fest, nicht das, was ein Aufruf heute kostet.
vocab:generate | Vokabellisten erzeugen. | Vokabelliste erzeugen |
lesson_plans:read | Deine Lektionspläne lesen und dich erneut mit ihrem Fortschritt verbinden. | Lektionsplan abrufenErneut mit einem Lektionsplan verbinden |
lesson_plans:write | Lektionspläne erstellen. | Lektionsplan erstellen |
tutor:converse | Tutorgespräche führen. Erfordert einen kostenpflichtigen Plan. | Tutor-Zug senden |
usage:read | Dein verbleibendes Kontingent sehen, oder die Nutzung eines `metered`-Clients in diesem Monat. | Verbleibendes Kontingent abrufen |
events:read | Ereignisse zu deinem Konto lesen und Endpunkte registrieren, die sie empfangen. | Ereignisse auflistenEreignisse streamen |
events:write | Ereignisse aus deinem Spiel oder deiner Integration an Lingara senden. | Ereignis senden |
embed:mint | Kurzlebige Tokens für die Spieler deines Spiels oder deiner Website ausstellen und Spieler löschen. Nur für nutzungsbasiert abgerechnete Clients. | Ein Token für einen Spieler ausstellenEinen Spieler löschenEinen Spieler von seinem Lingara-Konto trennen |
embed:play | Für einen Spieler handeln: seine Übungsergebnisse senden und NPC-Gespräche mit ihm führen. | Einen Spieler mit seinem Lingara-Konto verknüpfenEine Zeile an einen NPC senden |
Der Preis
Ein Credit kostet 0,004 US$. Die Nutzung wird monatlich abgerechnet, jeweils für einen Kalendermonat ab dem 1. (UTC), und der Karte deines Abonnements mit Nutzungsabrechnung belastet.
Ausgabenlimits
Dein Konto hat ein monatliches Limit in Credits, und jeder metered-Client kann ein eigenes, niedrigeres Limit haben; beide legst du auf der Seite Integrationen fest. Sobald der Client oder dein Konto sein Limit erreicht, werden die Aufrufe des Clients mit 402 und dem Code spend_cap_reached abgelehnt, bis der nächste Monat beginnt oder das Limit erhöht wird.
Wenn die Nutzungsabrechnung nicht aktiv ist
Die Aufrufe eines metered-Clients werden mit 402 und dem Code metered_billing_inactive abgelehnt, solange die Nutzungsabrechnung nicht aktiv ist: bevor sie eingerichtet ist, während eine Zahlung überfällig ist, und nachdem sie gekündigt wurde. Richte die Nutzungsabrechnung auf der Seite Integrationen unter app.getlingara.com/admin ein, verwalte oder kündige sie dort. Beim Verwalten öffnet sich das Abrechnungsportal von Stripe, wo du deine Karte ändern und deine Rechnungen lesen kannst.
Weichen eine Übersetzung und die englische Referenz voneinander ab, ist die englische Referenz maßgeblich.