ドキュメントUsage Logs
Billing
GET /v1/usage/logs
Fetch detailed usage history for request-level tables and billing visibility.
GET /v1/usage/logs権限: api.read
向いている用途
Teams building detailed billing tables and usage history pages.
Request history
Billing details
Per-request model tracking
呼び出し例
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.
すぐに試したいですか？
Settings で general API key を作成してから、ここに戻ってリクエスト例をコピーしてください。