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.
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
| Campo | Significado |
|---|---|
data.total_available | Cuota disponible de esta Key, en unidades internas de cuota. |
data.total_used | Cuota usada acumulada de esta Key, en las mismas unidades. |
data.total_granted | Suma de la cuota usada y disponible, en las mismas unidades. |
data.quota_currency | Moneda de la cuota, como USD. |
data.unlimited_quota | Si 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.

