Gerenciamento

Obter Faturamento de API Key

Retorna detalhamentos de faturamento agregados para uma API key de usuário.

GEThttps://api.tokenlab.sh/v1/management/api-keys/{keyId}/billing

Visão geral

Retorna o gasto total, contagem de requisições, uso faturável e custo agrupados por modelo, fabricante do modelo, cena e data.

Notas

  • Campos monetários são apenas em USD.

  • Recargas de workspace e faturas não estão incluídas.

  • Um endDate apenas com data significa 00:00 UTC no início daquele dia. Para incluir um dia inteiro, use a próxima data ou um horário RFC3339.

  • Um 429 com o código report_busy significa que a fila de relatórios está cheia. Tente novamente após os segundos indicados em Retry-After.

Exemplo

Suporta os mesmos filtros de modelo, fornecedor de modelo, cena e data que uso de API key. Retorna totais sem paginação.

Requisição

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?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.

Exemplo de resposta

Resposta

200 OK
{
  "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
  },
  "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

api_keyobject
Resumo da API key usando os mesmos campos das respostas de listagem/criação/atualização.
summaryobject
Totais agregados para os filtros selecionados.
breakdownsobject
Detalhamentos agregados para os filtros selecionados.
summary.total_requestsnumber
Contagem total de requisições.
summary.total_costnumber
Custo total em USD como um número JSON para exibição.
summary.total_cost_decimalstring
Custo total exato em USD como uma string decimal.
summary.total_prompt_tokensnumber
Total de tokens de prompt.
summary.total_completion_tokensnumber
Total de tokens de conclusão.
summary.total_tokensnumber
Total de tokens.
summary.usage_unit_breakdownarray
Quantidade de uso agrupada por unidade de uso.
breakdowns.by_modelarray
Detalhamento por modelo público solicitado.
breakdowns.by_logical_modelarray
Detalhamento por modelo público lógico.
breakdowns.by_model_vendorarray
Detalhamento por fornecedor de modelo público.
breakdowns.by_scenearray
Detalhamento por cena de requisição pública.
breakdowns.daily_costarray
Tendência de custo diário.

Autorização

ManagementTokenAuth
AuthorizationBearer <token>

Autenticação por token de gerenciamento. Crie ou gerencie Tokens de Gerenciamento em Dashboard > API > Management Tokens.

Local: header

Parâmetros de caminho

keyId*string

Parâmetros de consulta

model?string

Filtrar pelo nome do modelo solicitado. Comprimento máximo de 100.

Comprimentolength <= 100
modelVendor?string

Filtrar pelo fornecedor do modelo público. Comprimento máximo de 100.

Comprimentolength <= 100
scene?string

Filtrar por cena de solicitação pública.

Valores permitidos

  • "chat"
  • "image"
  • "audio"
  • "video"
  • "embedding"
  • "rerank"
  • "translation"
  • "music"
  • "3d"
  • "realtime"
  • "systemone"
startDate?string

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.

endDate?string

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