Skip to main content
GET
https://sajuapi.dev
/
v1
/
reports
/
usage
API 사용량 조회
curl --request GET \
  --url https://sajuapi.dev/v1/reports/usage \
  --header 'X-API-Key: <api-key>'
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
API 사용량 통계를 조회합니다. 기간별, 엔드포인트별 호출 횟수와 비용 정보를 확인할 수 있습니다.

​
Query 파라미터

​
period
string
default:"day"
집계 기간입니다. hour, day, week, month 중 하나입니다.
​
start_date
string
조회 시작 날짜입니다. ISO 8601 형식(YYYY-MM-DD)입니다. 기본값은 7일 전입니다.
​
end_date
string
조회 종료 날짜입니다. ISO 8601 형식(YYYY-MM-DD)입니다. 기본값은 오늘입니다.
​
group_by
string
default:"endpoint"
그룹화 기준입니다. endpoint, method, status_code 중 하나입니다.

​
Response

​
성공

API 사용량 조회에 성공하면 UsageReport 객체가 반환됩니다.

​
실패

상태 코드에러 타입설명
400validation_error쿼리 파라미터가 유효하지 않음
401authentication_errorAPI 키가 유효하지 않음
429rate_limited요청 한도 초과

​
요청 예시

curl -X GET "https://api.sajuapi.dev/v1/reports/usage?period=day&start_date=2025-01-10&end_date=2025-01-16" \
  -H "X-API-Key: bs_live_xxx"

​
응답 예시

{
  "period": "day",
  "start_date": "2025-01-10",
  "end_date": "2025-01-16",
  "summary": {
    "total_requests": 15420,
    "successful_requests": 15180,
    "failed_requests": 240,
    "success_rate": 98.44,
    "total_cost_usd": 12.45,
    "average_latency_ms": 245
  },
  "by_endpoint": [
    {
      "endpoint": "POST /v1/fortunes",
      "requests": 5230,
      "success_rate": 99.2,
      "average_latency_ms": 2340,
      "cost_usd": 8.50
    },
    {
      "endpoint": "GET /v1/fortunes/daily/{profile_id}",
      "requests": 4890,
      "success_rate": 99.8,
      "average_latency_ms": 45,
      "cost_usd": 0
    },
    {
      "endpoint": "POST /v1/profiles",
      "requests": 2100,
      "success_rate": 98.5,
      "average_latency_ms": 120,
      "cost_usd": 0
    },
    {
      "endpoint": "GET /v1/profiles",
      "requests": 1850,
      "success_rate": 99.9,
      "average_latency_ms": 85,
      "cost_usd": 0
    }
  ],
  "daily_breakdown": [
    {
      "date": "2025-01-10",
      "requests": 2100,
      "cost_usd": 1.75
    },
    {
      "date": "2025-01-11",
      "requests": 2250,
      "cost_usd": 1.82
    },
    {
      "date": "2025-01-12",
      "requests": 2180,
      "cost_usd": 1.78
    },
    {
      "date": "2025-01-13",
      "requests": 2050,
      "cost_usd": 1.65
    },
    {
      "date": "2025-01-14",
      "requests": 2340,
      "cost_usd": 1.90
    },
    {
      "date": "2025-01-15",
      "requests": 2200,
      "cost_usd": 1.80
    },
    {
      "date": "2025-01-16",
      "requests": 2300,
      "cost_usd": 1.75
    }
  ],
  "rate_limit_status": {
    "limit": 100000,
    "used": 15420,
    "remaining": 84580,
    "resets_at": "2025-02-01T00:00:00Z"
  }
}

​
UsageReport 객체

필드타입설명
periodstring집계 기간입니다.
start_datestring조회 시작 날짜입니다.
end_datestring조회 종료 날짜입니다.
summaryobject전체 요약 통계입니다.
by_endpointarray엔드포인트별 통계입니다.
daily_breakdownarray일별 분석입니다.
rate_limit_statusobject요청 한도 상태입니다.

​
비용 계산

API 호출 비용은 주로 AI 모델 사용에서 발생합니다.
모델비용 (대략)
haiku$0.001/요청
sonnet$0.002/요청
gpt4o$0.003/요청
캐시된 응답(cached: true)은 비용이 발생하지 않습니다. 캐시 히트율을 높여 비용을 절감하세요.