DocumentacionTokens IA (opcional)
Tokens IA (opcional)
Otorgamiento mensual, packs one-time y consumo en endpoints /ai.
Como funcionan los tokens
| Fuente | Comportamiento |
|---|---|
| Otorgamiento mensual del plan | Incluido por plan (ver Planes). Se reinicia cada ciclo tras invoice.paid de Stripe. Use it or lose it — no se acumulan. |
| Token packs (one-time) | Compras adicionales. No caducan y se suman al saldo mensual. |
| Consumo | Cada llamada IA debita AiTokenLedger segun uso del modelo. |
Token packs
| Pack | Tokens | Precio |
|---|---|---|
| Starter | 10,000 | 5 € |
| Growth | 50,000 | 20 € |
| Scale | 200,000 | 70 € |
La compra pasa por Stripe Checkout (misma infraestructura que el upgrade de plan). El payload exacto puede variar por despliegue — usa la seccion Billing del dashboard cuando este disponible.
Endpoints que consumen tokens
POST /ai/generate
POST /ai/improve
Authorization: Bearer <jwt o api key>
X-Tenant-Id: clxxxxxxxx
Si el saldo del tenant es insuficiente, la API devuelve error antes de ejecutar el modelo. Monitoriza el uso junto a la cuota de email en GET /billing/subscription y widgets del panel.
Mensual vs packs
Inicio ciclo → invoice.paid → grant plan.tokensIncludedMonth
Uso editor IA → debit ledger
Compra pack → credit ledger (persistente)