API keys, billing y límites

Todo lo que administrás desde el dashboard: cómo generar una key, cómo cargar saldo, cómo se calcula lo que pagás, dónde ver tu consumo y cómo ponerle un techo al gasto.

API keys

Desde /dashboard/keys creás una key con solo ponerle un nombre. La key generada empieza con el prefijo tg_live_ y se muestra una única vez al crearla — TokenGate solo guarda su hash, así que si la perdés hay que revocarla y generar una nueva.

1. Entrá a /dashboard/keys

   Necesitás saldo cargado (balance_cents > 0) antes de poder crear una key — es la misma regla prepago que rige toda la plataforma.

2. Ponele un nombre

   Útil para identificarla después en tu historial de uso si tenés varias (por ejemplo, una por entorno: prod, staging).

3. Copiá la key mostrada

   No va a volver a aparecer en texto plano en ningún lado del dashboard.

4. Revocala si hace falta

   Un botón "Revocar" por key la invalida al instante — cualquier request que la use después empieza a fallar con 401 invalid_api_key.

Una vez revocada no hay vuelta atrás: cualquier request que la use pasa a fallar con 401 invalid_api_key al instante, para siempre.

En esa misma pantalla ves, por key, cuántos requests hizo y cuánto gastó en total — útil para saber qué integración está consumiendo más.

Cargar saldo

TokenGate hoy solo acepta pagos manuales por QR Bre-B (Colombia, en pesos COP, convertidos a USD con la TRM del día). Desde /dashboard/billing:

1. Elegí un monto

   Hay presets fijos de $5.000, $10.000, $20.000, $30.000, $50.000 y $100.000 COP, cada uno con su QR ya armado con el monto embebido. También podés poner un monto libre — mínimo $1.000 COP.

2. Pagá el QR con tu app de Bre-B

   Se genera un pedido con un código de referencia único (TG-XXXXX) y 24 horas de validez.

3. Reportá el pago

   Subís el comprobante (imagen, hasta 5 MB) desde la misma pantalla para que un admin lo confirme.

4. Esperá la confirmación

   Un admin valida el comprobante y acredita el saldo — la operación queda registrada en tu historial de movimientos.

De pending se pasa directo a expired si nadie sube comprobante dentro de las 24 h.

Cómo se calcula lo que pagás

Cada modelo tiene un costo base por proveedor y un markup configurable que fija TokenGate. Lo que ves reflejado en tu saldo es:

precio_al_usuario = costo_del_proveedor × (1 + markup_percent / 100)

El markup varía por modelo (lo ves en el detalle de cada modelo dentro de /docs/modelos si el admin lo publica) y se aplica por separado a tokens de entrada, de salida, y de caché cuando el modelo lo soporta.

Uso

Desde /dashboard/usage ves, para el mes en curso: total de requests, tokens de entrada y salida, tokens leídos y escritos de caché, y el costo total — separado en costo de API y costo de Chat, porque se contabilizan por caminos distintos internamente. También aparece el detalle de tus últimos requests, cada uno marcado según de dónde vino (API, CLI o Chat) y contra qué proveedor real pegó.

Límites de gasto

En /dashboard/limits podés fijar un tope de gasto diario y/o mensual. Mientras no configures nada, no hay límite más allá de tu saldo disponible.

• Cada vez que hacés un request, TokenGate chequea tu gasto acumulado del día/mes antes de reservar el costo estimado.
• Si superarías el límite, el request se rechaza con 402 spending_limit_exceeded — no se cobra nada.
• Podés configurar alertas por email cuando tu saldo baja de un umbral, o cuando tu gasto diario/mensual se acerca al límite (con un margen de 6 horas entre avisos para no saturarte de mails).