Afrekening en credits
API-versie 2026-10-virile-dragon
Twee manieren van betalen
Een client wordt op een van twee manieren afgerekend, en zijn modus ligt vast zodra hij is aangemaakt. Een allowance-client verbruikt het tegoed van het abonnement van zijn eigenaar, hetzelfde tegoed als je apps, en brengt nooit iets in rekening op een kaart. Een metered-client verbruikt geen tegoed: elke aanroep kost credits, die in rekening worden gebracht op de kaart van je abonnement met verbruiksafrekening. Een aanroep die een app voor een andere gebruiker doet, met een token uit een autorisatiecode, verbruikt altijd het tegoed van die gebruiker, wat de modus van de client ook is.
Credits per aanroep
Een aanroep van een metered-client kost de credits die zijn scope waard is, zoals vermeld in de tabel hieronder; een scope van 0 credits kost niets. De units die GET /v1/usage meldt, worden met deze gewichten naar credits omgerekend. Een aanroep wordt afgerekend tegen de gewichten die gelden op de dag dat hij wordt gedaan, op welke versie de client ook is vastgezet: de tabel in de referentie van een oudere versie legt de gewichten vast van toen die versie werd gepubliceerd, niet wat een aanroep vandaag kost.
vocab:generate | Woordenlijsten genereren. | Een woordenlijst genereren |
lesson_plans:read | Je lesplannen lezen en opnieuw verbinden met hun voortgang. | Een lesplan ophalenOpnieuw verbinden met een lesplan |
lesson_plans:write | Lesplannen maken. | Een lesplan maken |
tutor:converse | Gesprekken met de tutor voeren. Vereist een betaald abonnement. | Een tutorbeurt versturen |
usage:read | Je resterende tegoed bekijken, of het gebruik van een `metered`-client deze maand. | Je resterende tegoed ophalen |
events:read | Events over je account lezen en endpoints registreren die ze ontvangen. | Gebeurtenissen weergevenGebeurtenissen streamen |
events:write | Events vanuit je game of integratie naar Lingara sturen. | Een gebeurtenis versturen |
embed:mint | Kortlevende tokens uitgeven voor de spelers van je game of site, en spelers verwijderen. Alleen voor clients met gebruiksafrekening. | Een token voor een speler uitgevenEen speler verwijderenEen speler ontkoppelen van zijn Lingara-account |
embed:play | Namens een speler handelen: diens oefenresultaten versturen en NPC-gesprekken met die speler voeren. | Een speler koppelen aan zijn Lingara-accountEen regel naar een NPC sturen |
De prijs
Eén credit kost US$0.004. Verbruik wordt maandelijks afgerekend, per kalendermaand vanaf de 1e (UTC), op de kaart van je abonnement met verbruiksafrekening.
Uitgavenlimieten
Je account heeft een maandelijkse limiet in credits, en elke metered-client kan een eigen, lagere limiet hebben; je stelt beide in op de pagina Integraties. Zodra de client of je account zijn limiet bereikt, worden de aanroepen van de client geweigerd met 402 en de code spend_cap_reached, totdat de volgende maand begint of de limiet wordt verhoogd.
Als verbruiksafrekening niet actief is
De aanroepen van een metered-client worden geweigerd met 402 en de code metered_billing_inactive zolang verbruiksafrekening niet actief is: voordat ze is ingesteld, zolang een betaling achterstallig is, en nadat ze is opgezegd. Je stelt verbruiksafrekening in, beheert ze of zegt ze op via de pagina Integraties, op app.getlingara.com/admin. Beheren opent het factureringsportaal van Stripe, waar je je kaart kunt wijzigen en je facturen kunt lezen.
Als een vertaling afwijkt van de Engelse referentie, is de Engelse referentie juist.