Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
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

  • Monetary fields are USD-only. CNY inputs are retired and return 400 currency_retired.
  • The response is paginated.
  • The response includes public billing and reporting fields only.
  • Each usage item can include billing_transaction_id after the underlying request reaches settled billing state. Use it together with request_id for request-level reconciliation.
  • Internal routing and physical channel metadata are intentionally hidden.

​
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.