Fatturazione e crediti
Versione API 2026-10-virile-dragon
Due modi di pagare
Un client viene fatturato in uno di due modi, e la sua modalità è fissata al momento della creazione. Un client allowance consuma la quota del piano del suo proprietario, la stessa quota delle tue app, e non addebita mai nulla su una carta. Un client metered non consuma quota: ogni sua chiamata costa crediti, addebitati sulla carta del tuo abbonamento con fatturazione a consumo. Una chiamata che un'app effettua per conto di un altro utente, con un token ottenuto da un codice di autorizzazione, consuma sempre la quota di quell'utente, qualunque sia la modalità del client.
Crediti per chiamata
Una chiamata di un client metered costa i crediti che vale il suo scope, elencati nella tabella qui sotto; uno scope che vale 0 crediti non costa nulla. Le units riportate da GET /v1/usage si convertono in crediti con questi pesi. Una chiamata viene fatturata con i pesi in vigore il giorno in cui viene effettuata, qualunque sia la versione a cui è fissato il client: la tabella nel riferimento di una versione precedente registra i pesi al momento della pubblicazione di quella versione, non quanto costa oggi una chiamata.
vocab:generate | Generare elenchi di vocaboli. | Genera un elenco di vocaboli |
lesson_plans:read | Leggere i tuoi piani di lezione e riconnettersi al loro avanzamento. | Ottieni un piano di lezioneRiconnettiti a un piano di lezione |
lesson_plans:write | Creare piani di lezione. | Crea un piano di lezione |
tutor:converse | Conversare con il tutor. Richiede un piano a pagamento. | Invia un turno al tutor |
usage:read | Vedere la quota rimanente, o l'utilizzo di un client `metered` in questo mese. | Ottieni la quota rimanente |
events:read | Leggere gli eventi relativi al tuo account e registrare gli endpoint che li ricevono. | Elenca gli eventiTrasmetti gli eventi |
events:write | Inviare eventi a Lingara dal tuo gioco o dalla tua integrazione. | Invia un evento |
embed:mint | Emettere token di breve durata per i giocatori del tuo gioco o sito ed eliminare giocatori. Solo client a consumo. | Emettere un token per un giocatoreEliminare un giocatoreScollega un giocatore dal suo account Lingara |
embed:play | Agire per un giocatore: inviare i suoi risultati di esercizio e tenere conversazioni con PNG. | Collega un giocatore al suo account LingaraInvia una battuta a un PNG |
Il prezzo
Un credito costa US$0.004. L'utilizzo viene fatturato mensilmente, per ogni mese di calendario a partire dal giorno 1 (UTC), sulla carta del tuo abbonamento con fatturazione a consumo.
Limiti di spesa
Il tuo account ha un limite mensile in crediti, e ogni client metered può avere un proprio limite più basso; imposta entrambi nella pagina Integrazioni. Quando il client o il tuo account raggiunge il proprio limite, le chiamate del client vengono rifiutate con 402 e il codice spend_cap_reached finché non inizia il mese successivo o il limite non viene aumentato.
Quando la fatturazione a consumo non è attiva
Le chiamate di un client metered vengono rifiutate con 402 e il codice metered_billing_inactive finché la fatturazione a consumo non è attiva: prima di configurarla, mentre un pagamento è scaduto e dopo che è stata annullata. Configura, gestisci o annulla la fatturazione a consumo nella pagina Integrazioni, su app.getlingara.com/admin. Gestirla apre il portale di fatturazione di Stripe, dove puoi cambiare la carta e consultare le tue fatture.
In caso di discrepanza tra una traduzione e il riferimento in inglese, fa fede il riferimento in inglese.