Saltar para o conteúdo principal

Visão geral

Este endpoint retorna o detalhamento de uso por API Key sem expor metadata de roteamento físico.

Parâmetros de query

ParâmetroTipoPadrões / limitesDescrição
pageintegerpadrão 1, mínimo 1Número da página começando em 1
limitintegerpadrão 50, mínimo 1, máximo 100Tamanho da página
logicalModelstringcomprimento máximo 100Nome do modelo lógico solicitado
modelVendorstringcomprimento máximo 100Fornecedor público do modelo
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform ou byok
startDatestring-Limite inferior inclusivo; aceita RFC3339 com fuso horário ou YYYY-MM-DD
endDatestring-Limite superior inclusivo; aceita RFC3339 com fuso horário ou YYYY-MM-DD
Se startDate e endDate forem enviados juntos, startDate deve ser anterior ou igual a endDate.

Observações

  • A resposta é paginada.
  • A resposta inclui apenas campos públicos de faturamento e reporting.
  • A metadata de roteamento interno e dos canais físicos permanece oculta de forma intencional.
  • Todos os campos monetários continuam disponíveis em USD e agora também incluem equivalentes de exibição em RMB, como cost_cny, total_cost_cny e cost_cny em cada breakdown.
  • api_key.exchange_rate é a taxa USD→CNY usada para todos os valores *_cny dessa resposta.

Exemplo

curl "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&accessChannel=platform&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

Requisição / Resposta

Consulte o painel interativo de OpenAPI acima para ver o schema exato e os campos da resposta.