Usage

Server

Request logs and usage analytics of the signed-in user.

List request logs

GET

https://ai.brandkamu.id

/api/usage/logs

The user's requests (API and playground), newest first, including failed ones. Prompt and response content are never stored. Defaults to the last 30 days; the range may span at most 366 days.

List request logs › query Parameters

from

string · date-time

Range start (RFC 3339). Default to minus 30 days.

to

string · date-time

Range end, exclusive (RFC 3339). Default now. The range may span at most 366 days.

key

string

An API key id, or playground for dashboard playground requests only.

model

string

Exact model slug.

limit

integer · min: 1 · max: 200

Default: 50

offset

integer · min: 0

Default: 0

List request logs › Responses

A page of logs.

UsageLog[] · required

total

integer · int64 · required

Get one request log

GET

https://ai.brandkamu.id

/api/usage/logs/{id}

Everything recorded about one request (no prompt or response content).

Get one request log › path Parameters

id

string · uuid · required

Get one request log › Responses

The log entry.

UsageLogDetail

id

string · uuid · required

upstream_id

string | null · required

The provider's response id.

model_slug

string · required

provider_slug

string · required

api_key_name

string | null · required

source

string · enum · required

Enum values:

api

playground

streamed

boolean · required

status_code

integer · required

finish_reason

string | null · required

prompt_tokens

integer · required

completion_tokens

integer · required

cached_tokens

integer · required

cache_write_tokens

integer · required

reasoning_tokens

integer · required

cost_nano

integer · int64 · required

Billed cost in nano-USD.

cost_breakdown

object | null · required

Cost split in nano-USD.

latency_ms

integer · required

ttft_ms

integer | null · required

tps

number | null · required

object | null · required

Generation parameters and counts (e.g. stream, temperature, max_tokens, messages count, tools count, endpoint), never content.

error_type

string | null · required

e.g. insufficient_credits, model_not_found, model_not_allowed, invalid_request, rate_limited, upstream_unavailable, stream_interrupted, or the provider's error type.

error_message

string | null · required

client_ip

string | null · required

user_agent

string | null · required

started_at

string · date-time · required

created_at

string · date-time · required

When the request finished.

GET/api/usage/logs/{id}

curl https://ai.brandkamu.id/api/usage/logs/:id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "upstream_id": "upstream_id",
  "model_slug": "model_slug",
  "provider_slug": "provider_slug",
  "api_key_name": "api_key_name",
  "source": "api",
  "streamed": true,
  "status_code": 0,
  "finish_reason": "finish_reason",
  "prompt_tokens": 0,
  "completion_tokens": 0,
  "cached_tokens": 0,
  "cache_write_tokens": 0,
  "reasoning_tokens": 0,
  "cost_nano": 0,
  "cost_breakdown": {
    "input": 0,
    "cache_read": 0,
    "cache_write": 0,
    "output": 0
  },
  "latency_ms": 0,
  "ttft_ms": 0,
  "tps": 0,
  "request_params": {},
  "error_type": "error_type",
  "error_message": "error_message",
  "client_ip": "client_ip",
  "user_agent": "user_agent",
  "started_at": "2024-08-25T15:00:00Z",
  "created_at": "2024-08-25T15:00:00Z"
}

json

application/json

Get usage analytics

GET

https://ai.brandkamu.id

/api/usage/summary

Totals, a time series and a per-model breakdown (top 50 by cost) for the same filters as the logs. Ranges up to 25 hours are bucketed per hour, longer ones per day, in time zone tz (default: the site time zone). Every bucket in the range appears, including empty ones.

Get usage analytics › query Parameters

from

string · date-time

Range start (RFC 3339). Default to minus 30 days.

to

string · date-time

Range end, exclusive (RFC 3339). Default now. The range may span at most 366 days.

key

string

An API key id, or playground for dashboard playground requests only.

model

string

Exact model slug.

tz

string

IANA time zone for grouping, e.g. Asia/Jakarta. Unknown zones return 400.

Get usage analytics › Responses

Summary.

UsageSummary

bucket

string · enum · required

Enum values:

hour

day

object · required

object[] · required

Top 50 models by cost.

GET/api/usage/summary

curl https://ai.brandkamu.id/api/usage/summary \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "bucket": "hour",
  "totals": {
    "requests": 0,
    "errors": 0,
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "cached_tokens": 0,
    "cost_nano": 0,
    "avg_ttft_ms": 0,
    "avg_tps": 0,
    "avg_latency_ms": 0
  },
  "series": [
    {
      "bucket": "2026-11-07T00:00:00",
      "requests": 0,
      "prompt_tokens": 0,
      "completion_tokens": 0,
      "cached_tokens": 0,
      "cost_nano": 0
    }
  ],
  "models": [
    {
      "model_slug": "model_slug",
      "requests": 0,
      "prompt_tokens": 0,
      "completion_tokens": 0,
      "cached_tokens": 0,
      "cost_nano": 0
    }
  ]
}

json

application/json

Get daily totals (last 30 days)

GET

https://ai.brandkamu.id

/api/usage/daily

Per-day totals for the last 30 days, grouped by UTC date. Only days with requests are included.

Get daily totals (last 30 days) › Responses

Days in ascending order.

DailyUsage[]

DailyUsage

day

string · date · required

requests

integer · int64 · required

tokens

integer · int64 · required

Prompt + completion tokens.

cost_nano

integer · int64 · required

nano-USD.

GET

https://ai.brandkamu.id

/api/usage/filters

Values for the usage filters — all the user's keys (including revoked ones, so their history can be filtered) and every model the user has called.

Filter options.

object[] · required

models

string[] · required

API Keys Billing

Usage

List request logs

List request logs › query Parameters

List request logs › Responses

Get one request log

Get one request log › path Parameters

Get one request log › Responses

Get usage analytics

Get usage analytics › query Parameters

Get usage analytics › Responses

Get daily totals (last 30 days)

Get daily totals (last 30 days) › Responses

Get filter options

Get filter options › Responses