Get API Key Usage

Returns paginated usage details for a user API key.

Overview

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

Query Parameters

Parameter	Type	Default / Limits	Notes
page	integer	default 1, min 1	1-based page number
limit	integer	default 50, min 1, max 100	Page size
logicalModel	string	max length 100	Requested logical model name
modelVendor	string	max length 100	Public model vendor
scene	enum	-	chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannel	enum	-	platform or byok
startDate	string	-	Inclusive lower bound; accepts RFC3339 with timezone or YYYY-MM-DD
endDate	string	-	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

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.