사용량

비용·호출 수·토큰 수를 기간·모델·멤버·키 단위로 확인할 수 있습니다. 확인하는 방법은 두 가지입니다. 호출 응답에 바로 담겨 오는 즉시 비용과, 누적을 보여 주는 대시보드입니다. 한도에 얼마나 가까운지 확인하거나, 비용이 어디서 많이 쓰이는지 볼 때 사용합니다.

자주 만나는 상황은 다음과 같습니다.

호출 시점에 비용 확인하기: 응답 단위 비용에서 usage.estimated_cost를 봅니다.
이번 달 누적 보기: Space 대시보드에서 누적 그래프를 봅니다.
월별 데이터 받기: CSV로 데이터를 받습니다.
한도에 가까운지 확인하기: 한도와 함께 보기에서 잔여를 봅니다.

사용량 분석

비용·호출 수·토큰 수를 기간·모델·멤버·키 단위로 확인합니다. 한도에 얼마나 가까운지 확인하거나, 비용이 어디서 많이 쓰이는지 볼 때 사용합니다.

시작 전 알아야 할 것

모든 금액은 USD 원가 기준입니다(단가).
응답 단위 비용(usage.estimated_cost)이 매 호출 응답에 들어갑니다. 별도 대시보드를 보지 않아도 호출 시점에 비용을 바로 확인할 수 있습니다.
Admin은 Space 전체와 멤버별·키별 사용량을 봅니다. Member는 자기 키와 자기 사용량만 봅니다.

두 가지 진입 방식

방식	무엇이 보이나	사용처
응답 단위	`usage.estimated_cost` 필드	코드 안에서 즉시 비용 계산
대시보드	기간·모델·멤버·키 단위 누적	트렌드, 한도 도달 임박 확인

응답 단위 비용

모든 엔드포인트의 응답에 usage 필드가 들어가고, 그 안에 usage.estimated_cost(USD)가 함께 들어갑니다.


{
  "id": "...",
  "choices": [...],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 48,
    "total_tokens": 60,
    "estimated_cost": 0.000324
  }
}

단위는 USD이고, 호출 시점 단가를 기준으로 합니다(요금).
Gateway가 추가하는 필드라서, 공급사 응답에는 들어 있지 않습니다.
streaming 응답은 마지막 chunk에 누적 usage가 도착합니다. 중간 chunk에는 부분 정보만 들어 있습니다.

Space 대시보드 (Admin)

사용량 탭 열기

왼쪽 메뉴에서 AI Gateway의 사용량 탭으로 들어갑니다.

분포 확인하기

다음 항목을 볼 수 있습니다.

항목	보여 주는 내용
누적 비용 그래프	기간별(일/주/월) 비용
모델별 분포	어느 모델이 얼마를 차지하는지
멤버별 분포	누가 얼마를 썼는지
키별 분포	어느 키가 비용을 가장 많이 썼는지

기간·한도 함께 보기

화면 상단에서 기간을 선택합니다(일/주/월/임의 범위). 한도 대비 잔여가 위 그래프에 점선으로 표시됩니다(Service / Member / Key).

Member 뷰

Member는 본인 사용량만 봅니다.

왼쪽 메뉴에서 AI Gateway의 내 사용량으로 들어갑니다.
본인 키 목록과 키별 이번 달 사용량, 합계를 확인합니다.
Member Limit 잔여를 확인합니다. 한도를 설정해 두었다면 잔여 USD가 보입니다.
키 행마다 Key Limit 잔여를 확인합니다.

기간·필터·정렬

옵션	가능한 값
기간	일 / 주 / 월 / 임의 범위
필터	모델 / 멤버 (Admin) / 키 / 에러 발생만
정렬	비용 ↓ / 호출 수 ↓ / 토큰 수 ↓ / 마지막 호출 시각

가장 자주 쓰는 필터는 에러 발생만입니다. 어느 키와 모델에서 4xx·5xx 오류가 자주 나는지 빠르게 확인할 수 있습니다.

CSV 다운로드

월별 데이터를 CSV로 내려받습니다.

대시보드 화면 우상단 다운로드 버튼을 누르면 월별 CSV를 받습니다. 컬럼은 시각·키·멤버·모델·prompt tokens·completion tokens·usage.estimated_cost입니다.

한도와 함께 보기

한도	대시보드에서 보는 자리
Service Limit	Space 전체 누적 그래프 위 점선
Member Limit	멤버 행의 잔여 USD
Key Limit	키 행의 잔여 USD

자세한 내용은 한도 개요를 참고합니다.

자주 만나는 오류

증상	원인 / 해결
호출은 됐는데 대시보드에 반영이 늦습니다	누적 데이터는 반영까지 수십 초~1분 걸립니다. 응답 단위 비용은 즉시 반영됩니다
응답의 비용과 대시보드의 비용이 다릅니다	지연, 반올림, 단가 변경 때문에 차이가 날 수 있습니다. 차이가 크면 `customer.service@letsur.ai` 로 문의합니다
Member인데 다른 멤버 사용량이 보입니다	권한 문제입니다. Admin 또는 `customer.service@letsur.ai` 로 즉시 문의합니다
합계가 예상과 다릅니다	기간과 필터를 먼저 확인합니다. 차이가 크면 응답의 `error_ref`를 첨부해 `customer.service@letsur.ai` 로 문의합니다
`usage.estimated_cost`가 응답에 안 보입니다	streaming 응답이라면 마지막 chunk를 확인합니다. 다른 엔드포인트라면 `customer.service@letsur.ai` 로 문의합니다

사용량