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

• 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

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.