Facturation et crédits
Version de l'API 2026-10-virile-dragon
Deux façons de payer
Un client est facturé de l'une de deux façons, et son mode est fixé à sa création. Un client allowance consomme le quota du forfait de son propriétaire, le même quota que vos applications, et ne débite jamais de carte. Un client metered ne consomme aucun quota : chacun de ses appels coûte des crédits, débités sur la carte de votre abonnement de facturation à l'usage. Un appel qu'une application effectue pour un autre utilisateur, avec un jeton issu d'un code d'autorisation, consomme toujours le quota de cet utilisateur, quel que soit le mode du client.
Crédits par appel
Un appel d'un client metered coûte les crédits que vaut sa portée, indiqués dans le tableau ci-dessous ; une portée qui vaut 0 crédit ne coûte rien. Les units que renvoie GET /v1/usage se convertissent en crédits selon ces poids. Un appel est facturé selon les poids en vigueur le jour où il est effectué, quelle que soit la version à laquelle le client est fixé : le tableau de la référence d'une version plus ancienne consigne les poids au moment de la publication de cette version, et non ce que coûte un appel aujourd'hui.
vocab:generate | Générer des listes de vocabulaire. | Générer une liste de vocabulaire |
lesson_plans:read | Lire vos plans de leçon et vous reconnecter à leur progression. | Obtenir un plan de leçonSe reconnecter à un plan de leçon |
lesson_plans:write | Créer des plans de leçon. | Créer un plan de leçon |
tutor:converse | Mener des conversations avec le tuteur. Nécessite un abonnement payant. | Envoyer un tour au tuteur |
usage:read | Voir votre quota restant, ou l'utilisation d'un client `metered` ce mois-ci. | Obtenir votre quota restant |
events:read | Lire les événements concernant votre compte, et enregistrer les points de terminaison qui les reçoivent. | Lister les événementsDiffuser les événements |
events:write | Envoyer des événements depuis votre jeu ou votre intégration vers Lingara. | Envoyer un événement |
embed:mint | Émettre des jetons de courte durée pour les joueurs de votre jeu ou de votre site, et supprimer des joueurs. Clients facturés à l'usage uniquement. | Émettre un jeton pour un joueurSupprimer un joueurDélier un joueur de son compte Lingara |
embed:play | Agir pour un joueur : envoyer ses résultats d'entraînement et tenir des conversations de PNJ avec lui. | Lier un joueur à son compte LingaraEnvoyer une réplique à un PNJ |
Le prix
Un crédit coûte 0,004 $ US. L'usage est facturé chaque mois, pour chaque mois civil commençant le 1er (UTC), sur la carte de votre abonnement de facturation à l'usage.
Limites de dépenses
Votre compte a une limite mensuelle en crédits, et chaque client metered peut avoir sa propre limite, plus basse ; définissez les deux sur la page Intégrations. Dès que le client ou votre compte atteint sa limite, les appels du client sont refusés avec 402 et le code spend_cap_reached jusqu'au début du mois suivant ou jusqu'à ce que la limite soit relevée.
Quand la facturation à l'usage n'est pas active
Les appels d'un client metered sont refusés avec 402 et le code metered_billing_inactive tant que la facturation à l'usage n'est pas active : avant sa configuration, pendant qu'un paiement est en retard, et après sa résiliation. Configurez, gérez ou résiliez la facturation à l'usage sur la page Intégrations, à app.getlingara.com/admin. La gérer ouvre le portail de facturation de Stripe, où vous pouvez changer de carte et consulter vos factures.
En cas de divergence entre une traduction et la référence en anglais, la référence en anglais fait foi.