Χρέωση και μονάδες πίστωσης

Έκδοση API 2026-10-virile-dragon

Δύο τρόποι πληρωμής

Ένας πελάτης χρεώνεται με έναν από δύο τρόπους, και ο τρόπος του ορίζεται οριστικά κατά τη δημιουργία του. Ένας πελάτης allowance καταναλώνει το όριο χρήσης του προγράμματος του κατόχου του, το ίδιο όριο χρήσης με τις εφαρμογές σας, και δεν χρεώνει ποτέ κάρτα. Ένας πελάτης metered δεν καταναλώνει όριο χρήσης: κάθε κλήση του κοστίζει μονάδες πίστωσης, που χρεώνονται στην κάρτα της συνδρομής σας χρέωσης βάσει χρήσης. Μια κλήση που κάνει μια εφαρμογή για λογαριασμό άλλου χρήστη, με διακριτικό από κωδικό εξουσιοδότησης, καταναλώνει πάντα το όριο χρήσης αυτού του χρήστη, ανεξάρτητα από τον τρόπο χρέωσης του πελάτη.

Μονάδες πίστωσης ανά κλήση

Μια κλήση ενός πελάτη metered κοστίζει όσες μονάδες πίστωσης αξίζει το εύρος δικαιωμάτων της, όπως παρατίθενται στον παρακάτω πίνακα· ένα εύρος που αξίζει 0 μονάδες πίστωσης δεν κοστίζει τίποτα. Οι units που αναφέρει το GET /v1/usage μετατρέπονται σε μονάδες πίστωσης με αυτά τα βάρη. Μια κλήση χρεώνεται με τα βάρη που ισχύουν την ημέρα που γίνεται, όποια κι αν είναι η έκδοση στην οποία είναι δεσμευμένος ο πελάτης: ο πίνακας στην αναφορά μιας παλαιότερης έκδοσης καταγράφει τα βάρη της στιγμής που δημοσιεύτηκε εκείνη η έκδοση, όχι το τι κοστίζει μια κλήση σήμερα.

Εύρη δικαιωμάτων
`vocab:generate`	Δημιουργία λιστών λεξιλογίου.	Δημιουργία λίστας λεξιλογίου
`lesson_plans:read`	Ανάγνωση των σχεδίων μαθήματός σας και επανασύνδεση στην πρόοδό τους.	Λήψη σχεδίου μαθήματος Επανασύνδεση σε σχέδιο μαθήματος
`lesson_plans:write`	Δημιουργία σχεδίων μαθήματος.	Δημιουργία σχεδίου μαθήματος
`tutor:converse`	Συνομιλίες με τον καθηγητή. Απαιτεί συνδρομητικό πρόγραμμα.	Αποστολή γύρου στον καθηγητή
`usage:read`	Προβολή του υπολοίπου του ορίου χρήσης σας ή της χρήσης ενός πελάτη `metered` αυτόν τον μήνα.	Λήψη του υπολοίπου του ορίου χρήσης σας
`events:read`	Ανάγνωση συμβάντων σχετικά με τον λογαριασμό σας και καταχώριση endpoint που τα λαμβάνουν.	Λίστα συμβάντων Ροή συμβάντων
`events:write`	Αποστολή συμβάντων από το παιχνίδι ή την ενσωμάτωσή σας στο Lingara.	Αποστολή συμβάντος
`embed:mint`	Έκδοση βραχύβιων tokens για τους παίκτες του παιχνιδιού ή του ιστότοπού σας και διαγραφή παικτών. Μόνο για πελάτες με χρέωση βάσει χρήσης.	Έκδοση token για έναν παίκτη Διαγραφή παίκτη Αποσύνδεση παίκτη από τον λογαριασμό του στο Lingara
`embed:play`	Ενέργεια για λογαριασμό ενός παίκτη: αποστολή των αποτελεσμάτων εξάσκησής του και συνομιλίες NPC μαζί του.	Σύνδεση παίκτη με τον λογαριασμό του στο Lingara Στείλε μια φράση σε έναν NPC

Η τιμή

Μία μονάδα πίστωσης κοστίζει 0,004 US$. Η χρήση χρεώνεται μηνιαία, για κάθε ημερολογιακό μήνα που ξεκινά την 1η (UTC), στην κάρτα της συνδρομής σας χρέωσης βάσει χρήσης.

Όρια δαπανών

Ο λογαριασμός σας έχει ένα μηνιαίο όριο σε μονάδες πίστωσης, και κάθε πελάτης metered μπορεί να έχει ένα δικό του, χαμηλότερο όριο· ορίστε και τα δύο στη σελίδα Ενσωματώσεις. Μόλις ο πελάτης ή ο λογαριασμός σας φτάσει το όριό του, οι κλήσεις του πελάτη απορρίπτονται με 402 και τον κωδικό spend_cap_reached μέχρι να αρχίσει ο επόμενος μήνας ή να αυξηθεί το όριο.

Όταν η χρέωση βάσει χρήσης δεν είναι ενεργή

Οι κλήσεις ενός πελάτη metered απορρίπτονται με 402 και τον κωδικό metered_billing_inactive όσο η χρέωση βάσει χρήσης δεν είναι ενεργή: πριν ρυθμιστεί, όσο μια πληρωμή είναι εκπρόθεσμη και αφού ακυρωθεί. Ρυθμίστε, διαχειριστείτε ή ακυρώστε τη χρέωση βάσει χρήσης στη σελίδα Ενσωματώσεις, στο app.getlingara.com/admin. Η διαχείριση ανοίγει την πύλη χρεώσεων του Stripe, όπου μπορείτε να αλλάξετε την κάρτα σας και να διαβάσετε τα τιμολόγιά σας.

Αν μια μετάφραση διαφέρει από την αγγλική τεκμηρίωση, ισχύει η αγγλική τεκμηρίωση.