Daftar penggunaan model
Model API key required. Mengembalikan bucket penggunaan model harian UTC untuk cakupan yang terlihat oleh kunci API terautentikasi. Menghilangkan `group_by[]` mengembalikan total harian.
Model API key required. Use apikey-...; management keys are not accepted. Returns UTC daily model usage buckets for the authenticated API key's visible scope. Omitting group_by[] returns total daily buckets.
Authorization
ModelKeyBearer Model API key required. Send Authorization: Bearer apikey-....
In: header
Query Parameters
Inclusive UTC start date in YYYY-MM-DD format.
dateExclusive UTC end date in YYYY-MM-DD format. The range can cover at most 180 daily buckets.
dateVisibility scope. self reads usage from the authenticated user's API keys. account requires account-level billing read permission.
"self"Value in
- "self"
- "account"
Repeated grouping parameter. Omit to return total daily buckets. Supported sets are model_type, model, api_key, and model plus api_key. Comma-delimited values are not accepted.
items <= 3Repeated model type filter. Omit to include text, image, and video.
items <= 3Repeated model ID filter. At most 100 IDs.
items <= 100Repeated API key public ID filter. Use the id (ak_...) returned by POST /public/v1/api-keys. Save it at creation; the key field (apikey-...) is the authentication secret, not this filter value.
items <= 100Maximum number of grouped rows to return.
1 <= value <= 1000100Opaque cursor from the previous response's next_page. Pass it back unchanged.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public/v1/model-usage?start_date=2026-05-01&end_date=2026-05-08&group_by%5B%5D=model&group_by%5B%5D=api_key&model_types%5B%5D=text&model_types%5B%5D=image&model_ids%5B%5D=deepseek-v3&api_key_ids%5B%5D=ak_abc123"{ "object": "list", "scope": "self", "data": [ { "object": "usage.bucket", "date": "2026-05-01", "start_at": "2026-05-01T00:00:00Z", "end_at": "2026-05-02T00:00:00Z", "covered_until": "2026-05-02T00:00:00Z", "partial": false, "results": [ { "object": "usage.result", "usage": { "requests": 12, "tokens": { "input": 12000, "output": 3000, "total": 15000, "cache_creation": 0, "cache_creation_1h": 0, "cache_read": 0, "input_image": 0, "output_image": 0 }, "images": null, "video": null } } ] } ], "has_more": false, "next_page": null, "request_id": "req_123"}Last updated on
Ambil saldo akun GET
Model API key required. Mengembalikan saldo akun saat ini dan ringkasan pemberian kredit untuk akun milik kunci API yang terautentikasi.
Daftar biaya model GET
Model API key required. Mengembalikan bucket biaya model harian UTC untuk cakupan yang terlihat oleh kunci API terautentikasi. Menghilangkan `group_by[]` mengembalikan total harian.