Skip to main content

​
Overview

This endpoint returns key-level usage details without exposing physical routing metadata.

​
Query Parameters

ParameterTypeDefault / LimitsNotes
pageintegerdefault 1, min 11-based page number
limitintegerdefault 50, min 1, max 100Page size
logicalModelstringmax length 100Requested logical model name
modelVendorstringmax length 100Public model vendor
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform or byok
startDatestring-Inclusive lower bound; accepts RFC3339 with timezone or YYYY-MM-DD
endDatestring-Inclusive upper bound; accepts RFC3339 with timezone or YYYY-MM-DD
If both startDate and endDate are present, startDate must be earlier than or equal to endDate.

​
Notes

  • The response is paginated.
  • The response includes public billing and reporting fields only.
  • Internal routing and physical channel metadata are intentionally hidden.
  • All monetary response fields remain available in USD and now also include RMB display companions: cost_cny, total_cost_cny, and cost_cny inside every breakdown entry.
  • api_key.exchange_rate is the USD→CNY rate used for all *_cny values in that response.

​
Example

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"

​
Request / Response

Use the interactive OpenAPI panel above for the exact schema and response fields.