Pular para o conteúdo
Cadastre-se grátis
Referência da API

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.

Janela do terminal
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

CampoSignificado
created_atTimestamp Unix em segundos.
model_nameID do modelo.
request_idQuando presente, use-o para relacionar o registro a uma solicitação ao modelo.
prompt_tokensQuantidade registrada de tokens de entrada, conforme o endpoint e o método de cobrança.
completion_tokensQuantidade registrada de tokens de saída, conforme o endpoint e o método de cobrança.
type2 indica um registro de consumo.
quotaValor de cota registrado, em unidades internas de cota.
recorded_amountValor como string decimal. Retornado em registros de consumo com um fator de conversão de cobrança salvo.
currencyMoeda 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.