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.
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.Ponele un nombre
Útil para identificarla después en tu historial de uso si tenés varias (por ejemplo, una por entorno:
prod,staging).Copiá la key mostrada
No va a volver a aparecer en texto plano en ningún lado del dashboard.
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.
creadaactivarevocadaUna 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:
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.
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.Reportá el pago
Subís el comprobante (imagen, hasta 5 MB) desde la misma pantalla para que un admin lo confirme.
Esperá la confirmación
Un admin valida el comprobante y acredita el saldo — la operación queda registrada en tu historial de movimientos.
pendingpaid_reportedconfirmedexpiredDe pending se pasa directo a expired si nadie sube comprobante dentro de las 24 h.
Podés tener como máximo 3 pedidos de recarga pendientes al mismo tiempo. Si uno vence sin pagarse (24 h), simplemente generás uno nuevo.
Cómo se calcula lo que pagás
TokenGate cobra su margen una sola vez, al recargar: retiene un platform fee sobre el monto que pagás y te acredita el resto. Después, el consumo se cobra al precio del proveedor, sin recargo por token.
El desglose completo se muestra antes de que pagues; el fee queda como un movimiento propio en tu historial de saldo (convertido a USD con la TRM congelada al crear la recarga).
Los precios del catálogo de modelos son los del proveedor, y se aplican 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:
El costo va separado en costo de API y costo de Chat porque se contabilizan por caminos distintos internamente. Cada request del detalle está 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.
Llega un request
TokenGate mira tu gasto acumulado del día y del mes antes de reservar el costo estimado.
Sí → 402
spending_limit_exceeded, no se cobra nada.
Pasa normal
El request se procesa y descuenta al costo real.
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).
Un límite de gasto y un saldo insuficiente devuelven códigos de error distintos (spending_limit_exceeded vs insufficient_balance) — si tu integración solo maneja uno de los dos vas a tener requests fallando sin explicación clara. Ver el catálogo de errores.