Ir al contenido
Regístrate gratis
Referencia de la API

Consultar los registros de una API Key

Obtén hasta 1.000 registros recientes de solicitudes de una BetterToken API Key. Consulta marcas de tiempo, ID de solicitud, tokens e importes en la moneda de cada registro.

Usa GET https://bettertoken.ai/api/log/token para consultar los registros recientes de solicitudes 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. La URL completa no incluye /v1.

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

Respuesta correcta

Si la consulta se completa correctamente, success es true y data contiene un array de registros de esta Key. Los registros añadidos más recientemente aparecen primero. Se devuelven hasta 1.000 registros.

Este endpoint no tiene paginación ni filtros por tiempo o ID de solicitud.

El ejemplo muestra solo los campos más habituales. Todos los valores son ilustrativos.

{
"success": true,
"message": "",
"data": [
{
"created_at": 1795046400,
"type": 2,
"model_name": "gpt-6.2-sol",
"request_id": "example-request-id",
"prompt_tokens": 120,
"completion_tokens": 48,
"quota": 600,
"recorded_amount": "0.0012",
"currency": "USD"
}
]
}

Interpretar cada registro

CampoSignificado
created_atMarca de tiempo Unix en segundos.
model_nameID del modelo.
request_idSi está presente, úsalo para relacionar el registro con una solicitud al modelo.
prompt_tokensCantidad registrada de tokens de entrada, según el endpoint y el método de facturación.
completion_tokensCantidad registrada de tokens de salida, según el endpoint y el método de facturación.
type2 indica un registro de consumo.
quotaValor de cuota registrado, en unidades internas de cuota.
recorded_amountImporte como cadena decimal. Se devuelve en registros de consumo con un factor de conversión de facturación guardado.
currencyMoneda del importe, como USD.

Procesar los importes

No interpretes la ausencia de recorded_amount como un cargo de cero. Suma los registros por separado para cada currency.

Consultas relacionadas

Para consultar el uso acumulado y la cuota disponible de esta Key, consulta Cuota de API Key. Para ver el historial de la cuenta, abre BetterToken Workspace.