계정

사용량 조회

지정된 기간의 지출/요청 수/토큰 합계를 모델별, API 키별, 앱 이름별 세 가지 차원으로 나누어 반환하고, 일별 시계열도 포함합니다. /v1/insights와 달리 이 엔드포인트에는 상위 모델 순위, 캐시 통계, 연간 히트맵이 없습니다 — 더 가벼운 집계 엔드포인트이며 사용자 지정 날짜 범위(period=custom)를 지원합니다. API 키 인증을 사용하면 Tavily 호환 key 및 account 객체도 반환됩니다. 현재 UTC 달력 월에 성공한 web_search_events의 credits를 search, extract, crawl, map, research별로 나눕니다. 기존 :online 이벤트는 search_usage에 포함됩니다. 세션 쿠키 호출에는 key 객체를 반환하지 않습니다. 추가 today 객체에는 UTC 날짜의 credits_used, free_credits_used, free_allowance_remaining과 다음 UTC 자정의 resets_at이 포함되며, 무료 허용량이 꺼져 있거나 대상이 아니면 잔여량은 null입니다. balance_usd는 현재 계정 잔액입니다.

GET/v1/usage

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

쿼리 파라미터

period

string

시간 범위, 기본값은 month. 세 가지 종류: 레거시 달력 용어(day/week/month/year), 현재를 끝점으로 하는 롤링 윈도우(15m…1y), 달력 정렬 윈도우(today…prev_year), 또는 custom(from/to 필요). 인식할 수 없는 값은 400을 반환합니다.

dayweekmonthyear15m30m1h3h1d2d1w1mo1ytodayyesterdaythis_weekprev_weekthis_monthprev_monththis_yearprev_yearcustom

Example: "month"

from

string

사용자 지정 기간의 시작(ISO 8601). period=custom일 때만 사용됩니다.

ISO 8601, required with period=custom

Example: "2026-07-01T00:00:00.000Z"

to

string

사용자 지정 기간의 끝(ISO 8601). period=custom일 때만 사용됩니다.

ISO 8601, required with period=custom

Example: "2026-07-27T00:00:00.000Z"

GET /v1/usage

1
2
curl "https://api.bazaarlink.ai/v1/usage?period=month" \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

응답 예시

성공. totals는 기간 합계입니다. byModel/byKey/byApp은 서로 독립적인 세 가지 분류입니다(중첩 관계 아님). timeSeries는 모델별로 구분된 일별 지출/토큰/요청 수 시리즈입니다. 아래 예시는 축약되었습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
{
  "period": "month",
  "since": "2026-07-01T00:00:00.000Z",
  "until": "2026-07-27T12:00:00.000Z",
  "credits": 42.5,
  "totals": {
    "spend": 4.82,
    "requests": 340,
    "tokens": 152000,
    "promptTokens": 120000,
    "completionTokens": 32000
  },
  "byModel": [
    {
      "model": "openai/gpt-4o",
      "spend": 4.82,
      "tokens": 152000,
      "requests": 340
    }
  ],
  "byKey": [
    {
      "keyId": "key_abc123",
      "keyName": "default",
      "spend": 4.82,
      "tokens": 152000,
      "requests": 340,
      "spendLimitUsd": null,
      "spendLimitPeriod": null
    }
  ],
  "byApp": [
    {
      "appName": "my-app",
      "spend": 4.82,
      "tokens": 152000,
      "requests": 340
    }
  ],
  "timeSeries": [
    {
      "date": "2026-07-01",
      "model": "openai/gpt-4o",
      "cost": 0.16,
      "tokens": 5200,
      "requests": 12
    }
  ]
}