Ir al contenido
Regístrate gratis
Referencia de la API

Consultar la cuota de una API Key

Consulta la cuota usada y disponible de una BetterToken API Key con autenticación Bearer. Convierte las unidades en dinero según la moneda y el factor de conversión.

Usa GET https://bettertoken.ai/api/usage/token/ para consultar la cuota usada y disponible de una BetterToken API Key.

Enviar una solicitud

Usa la misma BetterToken API Key con prefijo sk-... que utilizas para llamar a los modelos. Asígnala a la variable de entorno local BETTERTOKEN_API_KEY antes de ejecutar este comando.

Autentícate con Authorization: Bearer <API_KEY>. La solicitud no tiene parámetros ni cuerpo. Conserva la barra final; la URL completa no incluye /v1.

Ventana de terminal
curl -sS 'https://bettertoken.ai/api/usage/token/' \
-H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"

Respuesta correcta

code: true indica que la consulta se ha completado correctamente. Este fragmento de respuesta contiene valores de ejemplo.

{
"code": true,
"message": "ok",
"data": {
"object": "token_usage",
"name": "example-key",
"total_granted": 1000000,
"total_used": 250000,
"total_available": 750000,
"unlimited_quota": false,
"quota_currency": "USD"
}
}

Interpretar la cuota

CampoSignificado
data.total_availableCuota disponible de esta Key, en unidades internas de cuota.
data.total_usedCuota usada acumulada de esta Key, en las mismas unidades.
data.total_grantedSuma de la cuota usada y disponible, en las mismas unidades.
data.quota_currencyMoneda de la cuota, como USD.
data.unlimited_quotaSi es true, esta Key no tiene un límite de cuota independiente. El saldo de la cartera sigue limitando el gasto.

Convertir en dinero

Lee data.quota_per_unit en la respuesta de GET https://bettertoken.ai/api/status. Divide la cuota entre este factor para obtener un importe en la moneda data.quota_currency.

Importe disponible = data.total_available / data.quota_per_unit

Por ejemplo, con un factor de 500000, los valores del ejemplo dan 750000 / 500000 = 1.50 USD. Convierte la cuota usada de la misma manera.

Para ver el saldo de la cartera de tu cuenta, abre BetterToken Workspace. Este endpoint devuelve solo la cuota de la API Key que autentica la solicitud.

Para consultar las solicitudes recientes de esta Key, consulta Registros de una API Key.