Gerenciamento
Obter uso da API Key
Retorna detalhes de uso paginados para uma API key de usuário.
Visão geral
Retorna registros de uso paginados para uma API key.
Parâmetros de consulta
| Parâmetro | Tipo | Padrão / Limites | Notas |
|---|---|---|---|
page | integer | padrão 1, mín 1 | Número da página (base 1) |
limit | integer | padrão 50, mín 1, máx 100 | Tamanho da página |
model | string | máx 100 caracteres | Nome do modelo solicitado |
modelVendor | string | máx 100 caracteres | Fornecedor público do modelo |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone |
startDate | string | - | Limite inferior inclusivo; aceita RFC3339 com fuso horário ou YYYY-MM-DD (00:00 UTC) |
endDate | string | - | Limite superior inclusivo; aceita RFC3339 com fuso horário ou YYYY-MM-DD. Um valor apenas de data significa 00:00 UTC no início daquele dia, portanto, para incluir um dia inteiro, use a próxima data ou um horário RFC3339 |
Se startDate e endDate estiverem presentes, startDate deve ser anterior ou igual a endDate.
Notas
-
Campos monetários são apenas em USD.
-
A resposta é paginada.
-
Registros liquidados podem incluir
billing_transaction_id. Salve-o comrequest_idquando precisar associar uma cobrança a uma requisição. -
Os registros são classificados por
created_at, do mais recente para o mais antigo. -
Um erro
429com o códigoreport_busysignifica que a fila de relatórios está cheia. Tente novamente após o tempo indicado emRetry-After(em segundos).
Requisição
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=chat&startDate=2026-07-01&endDate=2026-07-31T23:59:59Z" \
-H "Authorization: Bearer mt-your-management-token"Requisição / Resposta
Esta página fornece o esquema OpenAPI e exemplos de requisição copiáveis. Envie requisições de gerenciamento a partir do seu terminal ou cliente com um Management Token; o envio direto não está disponível nesta página.
Resposta
{
"api_key": {
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-sonnet-4-6"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
},
"items": [
{
"request_id": "req_abc123",
"billing_transaction_id": "billtxn_abc123",
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"scene": "chat",
"usage_unit": "per_token",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500",
"prompt_tokens": 1000,
"completion_tokens": 500,
"total_tokens": 1500,
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"cache_write_tokens_5m": 0,
"cache_write_tokens_1h": 0,
"cost": 0.0012,
"cost_decimal": "0.0012",
"created_at": "2026-07-08T03:15:00.000Z",
"requested_policy": null,
"resolved_tier": null,
"charged_price_basis": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
},
"summary": {
"total_requests": 1,
"total_cost": 0.0012,
"total_cost_decimal": "0.0012",
"total_prompt_tokens": 1000,
"total_completion_tokens": 500,
"total_tokens": 1500,
"usage_unit_breakdown": [
{
"usage_unit": "per_token",
"usage_quantity": 1500
}
]
},
"breakdowns": {
"by_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_logical_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_model_vendor": [
{
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012
}
],
"by_scene": [
{
"scene": "chat",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012"
}
],
"daily_cost": [
{
"date": "2026-07-08T00:00:00.000Z",
"cost": 0.0012,
"cost_decimal": "0.0012"
}
]
}
}Campos importantes
page, limit, total e totalPages.per_token.auto, verified, official, null. Política de entrega solicitada, quando registrada.verified, official, null. Nível de entrega utilizado, quando registrado.measure.dimensions inclui webSearchCalls ou groundedPrompts, e effectiveUnitPrices inclui o preço de cada chamada como webSearch ou groundedPrompt.Autorização
ManagementTokenAuth Autenticação por token de gerenciamento. Crie ou gerencie Tokens de Gerenciamento em Dashboard > API > Management Tokens.
Local: header
Parâmetros de caminho
Parâmetros de consulta
Número da página baseado em 1. O padrão é 1.
1 <= value1Tamanho da página. O padrão é 50 e o máximo é 100.
1 <= value <= 10050Filtrar pelo nome do modelo solicitado. Comprimento máximo de 100.
length <= 100Filtrar pelo fornecedor do modelo público. Comprimento máximo de 100.
length <= 100Filtrar por cena de solicitação pública.
Valores permitidos
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
Limite inferior, inclusivo. Aceita RFC3339 com fuso horário (por exemplo 2026-03-28T00:00:00+08:00) ou YYYY-MM-DD, que significa 00:00 UTC.
Limite superior, inclusivo. Aceita RFC3339 com fuso horário (por exemplo 2026-03-28T23:59:59+08:00) ou YYYY-MM-DD, que significa 00:00 UTC no início daquele dia. Para incluir um dia inteiro, passe a data do dia seguinte ou um horário RFC3339 no final do dia.
Resposta
application/json
application/json
application/json
application/json
application/json
application/json