사용량 분석
월별 또는 일별 사용량과 호출 수 비교
KST 기준으로 에셋과 API 키별 누적 사용량을 비교하고, 역할에 따른 조회 범위와 집계 기준, 값이 다를 때의 확인 방법을 설명합니다.
페이지 목차
분석에서 비교하는 값
AI 게이트웨이 > 사용량 분석 화면은 이미 발생한 모델 사용을 한국 표준시(KST) 기준의 월별 또는 일별로 보여줍니다. 에셋별 또는 API 키별 누적 사용량(unit)과 호출 수를 비교할 수 있습니다.
조회할 수 있는 범위는 역할에 따라 다릅니다.
| 작업 | Admin | Member |
|---|---|---|
| API 키별 사용량 보기 | 현재 스페이스의 모든 API 키 | 자신이 만든 API 키만. 다른 사용자의 키 이름, 사용량과 비용은 표시되지 않음 |
스페이스 관리자(Admin)는 스페이스 전체 범위에서 선택한 월 또는 일의 구성원별 집계도 확인할 수 있습니다. Admin이 구성원별 이번 달 사용량과 한도를 함께 확인하려면 구성원 월 한도 관리로 이동합니다. 키를 생성, 변경 또는 삭제하려면 API 키의 작업별 권한과 절차를 확인하세요.
한 구성원의 사용량 추이나 고객 작업별 사용량을 분석하려면 요청별 사용 기록을 고객 시스템에서 별도로 관리합니다.
집계에 포함되는 요청과 정보
분석에는 정상 완료된 호출과 실제 유닛이 차감된 호출이 포함됩니다.
| 요청 | 집계 |
|---|---|
| 정상 완료된 호출 | 호출 수와 사용량에 포함 |
| 스트리밍 도중 응답이 중단됐지만 사용량이 발생해 유닛이 차감된 호출 | 호출 수와 사용량에 포함 |
| 인증 실패나 월 한도 초과처럼 모델 호출 전에 거절되어 유닛이 차감되지 않은 요청 | 포함되지 않음 |
과금과 분석 집계에는 요청 시각, 공개 모델 코드, 토큰과 처리량, 비용, 상태와 오류 유형 및 요청 식별자 같은 메타데이터가 사용됩니다. 이 집계 항목에는 프롬프트나 모델 응답 본문이 포함되지 않습니다.
월 또는 일을 선택해 사용처 비교하기
현재 스페이스의 분석 열기
왼쪽 메뉴에서 AI 게이트웨이 > 사용량 분석으로 이동합니다.
기간과 지표 확인하기
조회할 KST 월 또는 일을 선택하고 조회가 끝난 뒤 총 unit 사용량과 호출 수를 확인합니다. 고객 시스템의 로그와 대조할 때도 요청 시각을 KST로 맞춥니다.
에셋과 API 키 비교하기
에셋별 표에서 모델 사용 비중을, API 키별 표에서 호출에 사용된 키를 확인합니다. 호출한 시스템을 확인하려면 키 이름과 고객 시스템의 사용처 기록을 대조합니다.
요청별 비용과 잔액 확인하기
분석 화면의 누적 사용량(unit)은 호출 한 건의 비용이나 남은 잔액이 아닙니다. 값별 확인 위치와 unit, USD 및 KRW 값을 대조하는 조건은 요금 및 사용량 안내에서 확인합니다.
콘솔 없이 서버에서 조회하기
서버에서 조회하려면 별도의 관리 API 키로 관리 API를 호출합니다. 관리 API의 월별 비용은 USD이므로 분석 화면의 unit 값과 바로 비교할 수 없습니다. 서버에서 비용과 사용량을 기록하는 방법은 요금 및 사용량 안내에서 확인합니다.
데이터가 보이지 않거나 다를 때
| 증상 | 다음 행동 |
|---|---|
| 기간을 바꿨지만 이전 값이 남아 있음 | 조회가 끝난 뒤 표시된 값이 선택한 기간의 결과인지 확인합니다. 오류가 표시되면 기간을 다시 선택합니다. |
| 조회에 실패했다는 오류가 표시됨 | 이 오류는 사용량 0을 뜻하지 않습니다. 기간을 다시 선택하고, 계속 실패하면 아래 정보로 문의합니다. |
| 호출 직후 값이 보이지 않음 | 잠시 후 새로고침하고 월별 또는 일별 기준, 현재 스페이스와 API 키를 다시 확인합니다. |
| 값이 비어 있거나 0으로 보임 | 빈 값이나 0만으로 해당 기간에 사용이 없었다고 확정하지 않습니다. 월별 또는 일별 기준, 현재 스페이스와 조회할 수 있는 키를 확인하고 최근 호출은 잠시 후 다시 조회합니다. |
| 응답의 호출 비용과 누적값이 다름 | 한 건의 비용과 누적 집계는 범위 및 반영 시점이 다릅니다. 요청별 비용의 기록 시점을 확인합니다. |
고객 시스템의 호출 기록과 계속 다르면 플랫폼 내 문의 기능에 스페이스 이름, 조회 기간, API 키 이름과 오류 내용을 남깁니다. API 키 값은 보내지 마세요.