DocsUsage Logs
Billing
GET /v1/usage/logs
Fetch detailed usage history for request-level tables and billing visibility.
GET /v1/usage/logsScope: api.read
Best for
Teams building detailed billing tables and usage history pages.
Request history
Billing details
Per-request model tracking
How to call it
json
{
"model": "kling-3.0",
"prompt": "機器人在極簡工作室中慢慢抬頭",
"mode": "std",
"aspectRatio": "16:9",
"generateAudio": false
}What this API is for
Use this endpoint for detailed usage tables.
It is best suited for history, filters, and billing drill-down views.
Parameters
page / limit
Optional pagination controls if supported by your backend.
date range
Optional filters for history windows if supported.
model
Optional filter when you want model-specific history.
Response fields
logs
Array of usage records.
model
Model used for the request.
pointsCharged
Points charged for that request when applicable.
usage
Token or usage metrics when relevant.
createdAt
Request timestamp.
Frontend notes
- Use logs for detailed tables, not summary cards.
- Expose model, time, and charged points clearly.
- Keep filtering simple so customers can trace spend.
Ready to test with your own key?
Create a general API key in Settings, then come back here to copy a request example.