Skip to main content
GET
/
v1
/
reports
/
usage
API 사용량 조회
curl --request GET \
  --url https://sajuapi.dev/v1/reports/usage \
  --header 'X-API-Key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.sajuapi.dev/llms.txt

Use this file to discover all available pages before exploring further.

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)은 비용이 발생하지 않습니다. 캐시 히트율을 높여 비용을 절감하세요.