Facturación y créditos
Versión de la API 2026-10-virile-dragon
Dos formas de pagar
Un cliente se factura de una de dos formas, y su modo queda fijado al crearlo. Un cliente allowance consume la cuota del plan de su propietario, la misma cuota que tus aplicaciones, y nunca cobra a una tarjeta. Un cliente metered no consume cuota: cada una de sus llamadas cuesta créditos, que se cobran a la tarjeta de tu suscripción de facturación por uso. Una llamada que una aplicación hace en nombre de otro usuario, con un token obtenido de un código de autorización, siempre consume la cuota de ese usuario, sea cual sea el modo del cliente.
Créditos por llamada
Una llamada de un cliente metered cuesta los créditos que vale su ámbito, que se enumeran en la tabla siguiente; un ámbito que vale 0 créditos no cuesta nada. Las units que informa GET /v1/usage se convierten en créditos con estos pesos. Una llamada se factura con los pesos vigentes el día en que se hace, sea cual sea la versión a la que está fijado el cliente: la tabla de la referencia de una versión anterior recoge los pesos del momento en que se publicó esa versión, no lo que cuesta una llamada hoy.
vocab:generate | Generar listas de vocabulario. | Generar una lista de vocabulario |
lesson_plans:read | Leer tus planes de lección y reconectarte a su progreso. | Obtener un plan de lecciónReconectarse a un plan de lección |
lesson_plans:write | Crear planes de lección. | Crear un plan de lección |
tutor:converse | Mantener conversaciones con el tutor. Requiere un plan de pago. | Enviar un turno al tutor |
usage:read | Consultar tu cuota restante, o el uso de un cliente `metered` este mes. | Obtener tu cuota restante |
events:read | Leer eventos sobre tu cuenta y registrar endpoints que los reciban. | Listar eventosTransmitir eventos |
events:write | Enviar eventos desde tu juego o integración a Lingara. | Enviar un evento |
embed:mint | Emitir tokens de corta duración para los jugadores de tu juego o sitio, y eliminar jugadores. Solo para clientes con facturación por uso. | Emitir un token para un jugadorEliminar un jugadorDesvincular un jugador de su cuenta de Lingara |
embed:play | Actuar en nombre de un jugador: enviar sus resultados de práctica y mantener conversaciones de PNJ con él. | Vincular un jugador a su cuenta de LingaraEnviar una frase a un PNJ |
El precio
Un crédito cuesta 0,004 US$. El uso se factura mensualmente, por cada mes natural a partir del día 1 (UTC), a la tarjeta de tu suscripción de facturación por uso.
Límites de gasto
Tu cuenta tiene un límite mensual en créditos, y cada cliente metered puede tener un límite propio más bajo; configura ambos en la página Integraciones. En cuanto el cliente o tu cuenta alcanza su límite, las llamadas del cliente se rechazan con 402 y el código spend_cap_reached hasta que empiece el mes siguiente o se aumente el límite.
Cuando la facturación por uso no está activa
Las llamadas de un cliente metered se rechazan con 402 y el código metered_billing_inactive mientras la facturación por uso no esté activa: antes de configurarla, mientras haya un pago vencido y después de cancelarla. Configura, gestiona o cancela la facturación por uso en la página Integraciones, en app.getlingara.com/admin. Al gestionarla se abre el portal de facturación de Stripe, donde puedes cambiar tu tarjeta y consultar tus facturas.
Si una traducción y la referencia en inglés difieren, prevalece la referencia en inglés.