Faturação e créditos
Versão da API 2026-10-virile-dragon
Duas formas de pagar
Um cliente é faturado de uma de duas formas, e o seu modo fica fixado quando é criado. Um cliente allowance gasta a quota do plano do seu dono, a mesma quota que as suas aplicações, e nunca cobra num cartão. Um cliente metered não gasta quota: cada uma das suas chamadas custa créditos, cobrados no cartão da sua subscrição de faturação por utilização. Uma chamada que uma aplicação faz em nome de outro utilizador, com um token obtido a partir de um código de autorização, gasta sempre a quota desse utilizador, seja qual for o modo do cliente.
Créditos por chamada
Uma chamada de um cliente metered custa os créditos que o seu âmbito vale, indicados na tabela abaixo; um âmbito que vale 0 créditos não custa nada. As units indicadas por GET /v1/usage convertem-se em créditos com estes pesos. Uma chamada é faturada com os pesos em vigor no dia em que é feita, seja qual for a versão em que o cliente está fixado: a tabela na referência de uma versão mais antiga regista os pesos de quando essa versão foi publicada, não o que uma chamada custa hoje.
vocab:generate | Gerar listas de vocabulário. | Gerar uma lista de vocabulário |
lesson_plans:read | Consultar os seus planos de aula e voltar a ligar-se ao seu progresso. | Obter um plano de aulaVoltar a ligar-se a um plano de aula |
lesson_plans:write | Criar planos de aula. | Criar um plano de aula |
tutor:converse | Manter conversas com o tutor. Requer um plano pago. | Enviar uma mensagem ao tutor |
usage:read | Ver a sua quota restante, ou a utilização de um cliente `metered` este mês. | Obter a sua quota restante |
events:read | Ler eventos sobre a sua conta e registar endpoints que os recebem. | Listar eventosTransmitir eventos |
events:write | Enviar eventos do seu jogo ou integração para o Lingara. | Enviar um evento |
embed:mint | Emitir tokens de curta duração para os jogadores do seu jogo ou site, e excluir jogadores. Apenas clientes com faturação por uso. | Emitir um token para um jogadorExcluir um jogadorDesvincular um jogador da sua conta Lingara |
embed:play | Agir por um jogador: enviar os seus resultados de prática e manter conversas de NPC com ele. | Vincular um jogador à sua conta LingaraEnviar uma fala a um NPC |
O preço
Um crédito custa US$0.004. A utilização é faturada mensalmente, por cada mês civil a começar no dia 1 (UTC), no cartão da sua subscrição de faturação por utilização.
Limites de gastos
A sua conta tem um limite mensal em créditos, e cada cliente metered pode ter um limite próprio mais baixo; defina ambos na página Integrações. Assim que o cliente ou a sua conta atinge o limite, as chamadas do cliente são recusadas com 402 e o código spend_cap_reached até começar o mês seguinte ou o limite ser aumentado.
Quando a faturação por utilização não está ativa
As chamadas de um cliente metered são recusadas com 402 e o código metered_billing_inactive enquanto a faturação por utilização não estiver ativa: antes de ser configurada, enquanto um pagamento estiver em atraso e depois de ser cancelada. Configure, gira ou cancele a faturação por utilização na página Integrações, em app.getlingara.com/admin. Geri-la abre o portal de faturação da Stripe, onde pode alterar o seu cartão e consultar as suas faturas.
Se uma tradução e a referência em inglês divergirem, prevalece a referência em inglês.