Skip to main content
GET
Obtiene el saldo restante y utilizado de la API Key (token) actual. Este endpoint se utiliza para monitorear el uso de un único token.

Autorización

string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:

Endpoints

Ambos endpoints tienen la misma funcionalidad; puede utilizar cualquiera de ellos.

Respuesta

boolean
Indica si la solicitud fue exitosa
string
Mensaje de error (solo se devuelve en caso de fallo)
float
Saldo restante del token (se devuelve en caso de éxito). Devuelve -1 cuando unlimited_quota es true
integer
Créditos restantes del token (se devuelve en caso de éxito). Devuelve -1 cuando unlimited_quota es true
float
Saldo utilizado del token (se devuelve en caso de éxito)
integer
Créditos utilizados del token (se devuelve en caso de éxito)
boolean
Indica si el token tiene cuota ilimitada. true significa ilimitada, false significa limitada

Casos de uso

  • Monitorear el consumo de una única API Key
  • Mostrar el saldo actual del token en su aplicación
  • Configurar alertas de saldo cuando este caiga por debajo de un umbral
Información sobre la unidad del saldoLa unidad del valor del saldo depende de la configuración del sistema:
  • USD - Dólares estadounidenses
  • Credits - Créditos
Token con cuota ilimitadaCuando un token se configura con cuota ilimitada:
  • El campo unlimited_quota devuelve true
  • El campo remain_balance devuelve -1
  • El campo remain_credits devuelve -1
  • El token no tiene restricciones de cuota y puede usarse sin límites

Errores comunes

Nota de seguridadSu API Key es como una contraseña. Manténgala segura y no la comparta con nadie. Utilice siempre HTTPS en producción.