사용량 분석
에셋과 API 키별 누적 사용량 및 호출 추이를 비교하세요.
월별 또는 일별 집계 기준, 에셋 및 API 키별 분류와 다른 비용 값의 차이를 다룹니다.
분석에서 집계하는 값
| 구분 | 현재 제공 범위 |
|---|---|
| 시간 기준 | 월별 또는 일별 |
| 분류 기준 | 에셋 및 API 키 |
| 지표 | 누적 사용량(unit)과 호출 수 |
구성원별 집계, 주별 또는 임의 기간 집계 및 CSV는 현재 제공 범위로 안내하지 않습니다.
Admin은 현재 스페이스의 모든 API 키 사용량을 보고, Member는 자신이 만든 API 키의 사용량만 봅니다. Member에게는 다른 사용자의 키 이름, 사용량 및 비용이 표시되지 않습니다.
분석에는 정상 완료된 호출과 실제 유닛이 차감된 호출이 포함됩니다. 스트리밍 도중 응답이 중단되었더라도 사용량이 발생해 유닛이 차감됐다면 호출 수와 사용량에 반영됩니다. 인증 실패나 월 한도 초과처럼 모델 호출 전에 거절되어 유닛이 차감되지 않은 요청은 분석 집계에 포함되지 않습니다.
과금과 분석 집계에는 요청 시각, 공개 모델 코드, 토큰과 처리량, 비용, 상태와 오류 유형 및 요청 식별자 같은 메타데이터가 사용됩니다. 이 집계 항목에는 프롬프트나 모델 응답 본문이 포함되지 않습니다.
사용량 비교하기
분석 열기
왼쪽 메뉴에서 AI 게이트웨이 > 분석으로 이동합니다.
시간 기준 선택하기
월 또는 일을 선택해 총 사용량과 호출 수의 변화를 확인합니다.
에셋과 API 키 비교하기
에셋별 표에서 모델 사용 비중을, API 키별 표에서 어느 사용처에서 호출이 발생했는지 확인합니다. 두 표의 사용량은 unit으로 표시됩니다.
요청 비용, 유닛 잔액 및 미결제 금액과 구분하기
- 호출 한 건의 비용
- API 응답의
estimated_cost: 호출별 비용 해석하고 저장하기와 엔드포인트별 응답 구조 보기 - 보유 유닛, 이번 달 초과 유닛 및 호출 차단 상태
- 유닛 잔액과 차단 상태 보기
- API 키별 월 한도
- API 키 월 한도 정하기
- 저장 카드, KRW 미결제금, 거래 및 제공되는 증빙
- 카드, 미결제금 및 거래 내역 관리하기
스트리밍에서는 누적 usage가 있는 event에 호출 비용이 제공될 수 있습니다. event 위치는 엔드포인트마다 다르므로 해당 API 레퍼런스를 확인하고, event를 받지 못했다면 분석에 반영된 누적 unit을 확인합니다.
콘솔 없이 서버에서 조회하기
콘솔에 자주 접속하지 않는다면 Platform API를 사용해 운영 데이터 수집을 자동화할 수 있습니다.
- 월별 모델 및 API 키 cost
GET /usage로 KST 월 단위 집계를 조회합니다.- 현재 유닛 잔액과 차단 상태
GET /balance로 보유 및 초과 unit과 차단 여부를 조회합니다.
Platform API와 콘솔 분석은 조회 기간, 단위 및 분류 기준이 다릅니다. 일별이나 고객 작업별 비용이 필요하면 API 응답의 estimated_cost를 요청 시각 및 고객 시스템의 작업 식별자와 함께 저장합니다.
데이터가 보이지 않거나 다를 때
| 증상 | 확인할 것 |
|---|---|
| 호출 직후 값이 보이지 않습니다 | 잠시 후 새로고침하고 월별 또는 일별 기준과 API 키를 다시 확인합니다 |
| 응답의 호출 비용과 누적값이 다릅니다 | 요청 한 건과 누적 집계는 범위 및 반영 시점이 다릅니다. 호출별 비용과 누적 사용량의 차이를 먼저 구분합니다 |