Consultar os logs de uma API Key
Consulte até 1.000 registros recentes de solicitações de uma BetterToken API Key. Entenda os horários, IDs de solicitação, tokens e valores na moeda de cada registro.
Use GET https://bettertoken.ai/api/log/token para consultar os logs recentes de solicitações de uma BetterToken API Key.
Enviar uma solicitação
Use a mesma BetterToken API Key com prefixo sk-... que você usa para chamar os modelos. Defina-a na variável de ambiente local BETTERTOKEN_API_KEY antes de executar este comando.
Autentique-se com Authorization: Bearer <API_KEY>. A solicitação não tem parâmetros nem corpo. A URL completa não inclui /v1.
curl -sS 'https://bettertoken.ai/api/log/token' \ -H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"Resposta de sucesso
Quando a consulta é concluída com sucesso, success é true e data contém um array de logs desta Key. Os registros gravados mais recentemente aparecem primeiro. São retornados até 1.000 registros.
Este endpoint não tem paginação nem filtros por tempo ou ID de solicitação.
O exemplo mostra apenas os campos mais comuns. Todos os valores são 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
| Campo | Significado |
|---|---|
created_at | Timestamp Unix em segundos. |
model_name | ID do modelo. |
request_id | Quando presente, use-o para relacionar o registro a uma solicitação ao modelo. |
prompt_tokens | Quantidade registrada de tokens de entrada, conforme o endpoint e o método de cobrança. |
completion_tokens | Quantidade registrada de tokens de saída, conforme o endpoint e o método de cobrança. |
type | 2 indica um registro de consumo. |
quota | Valor de cota registrado, em unidades internas de cota. |
recorded_amount | Valor como string decimal. Retornado em registros de consumo com um fator de conversão de cobrança salvo. |
currency | Moeda do valor, como USD. |
Tratar os valores
Não trate a ausência de recorded_amount como uma cobrança de valor zero. Some os registros separadamente para cada currency.
Consultas relacionadas
Para consultar o uso acumulado e a cota restante desta Key, veja Cota da API Key. Para ver o histórico da conta, abra o BetterToken Workspace.

