본문으로 건너뛰기

사용량 분석

월별 또는 일별 사용량과 호출 수 비교

KST 기준으로 에셋과 API 키별 누적 사용량을 비교하고, 역할에 따른 조회 범위와 집계 기준, 값이 다를 때의 확인 방법을 설명합니다.

페이지 목차

분석에서 비교하는 값

AI 게이트웨이 > 사용량 분석 화면은 이미 발생한 모델 사용을 한국 표준시(KST) 기준의 월별 또는 일별로 보여줍니다. 에셋별 또는 API 키별 누적 사용량(unit)과 호출 수를 비교할 수 있습니다.

조회할 수 있는 범위는 역할에 따라 다릅니다.

작업AdminMember
API 키별 사용량 보기현재 스페이스의 모든 API 키자신이 만든 API 키만. 다른 사용자의 키 이름, 사용량과 비용은 표시되지 않음

스페이스 관리자(Admin)는 스페이스 전체 범위에서 선택한 월 또는 일의 구성원별 집계도 확인할 수 있습니다. Admin이 구성원별 이번 달 사용량과 한도를 함께 확인하려면 구성원 월 한도 관리로 이동합니다. 키를 생성, 변경 또는 삭제하려면 API 키의 작업별 권한과 절차를 확인하세요.

한 구성원의 사용량 추이나 고객 작업별 사용량을 분석하려면 요청별 사용 기록을 고객 시스템에서 별도로 관리합니다.

집계에 포함되는 요청과 정보

분석에는 정상 완료된 호출과 실제 유닛이 차감된 호출이 포함됩니다.

요청집계
정상 완료된 호출호출 수와 사용량에 포함
스트리밍 도중 응답이 중단됐지만 사용량이 발생해 유닛이 차감된 호출호출 수와 사용량에 포함
인증 실패나 월 한도 초과처럼 모델 호출 전에 거절되어 유닛이 차감되지 않은 요청포함되지 않음

과금과 분석 집계에는 요청 시각, 공개 모델 코드, 토큰과 처리량, 비용, 상태와 오류 유형 및 요청 식별자 같은 메타데이터가 사용됩니다. 이 집계 항목에는 프롬프트나 모델 응답 본문이 포함되지 않습니다.

월 또는 일을 선택해 사용처 비교하기

  1. 현재 스페이스의 분석 열기

    왼쪽 메뉴에서 AI 게이트웨이 > 사용량 분석으로 이동합니다.

  2. 기간과 지표 확인하기

    조회할 KST 월 또는 일을 선택하고 조회가 끝난 뒤 총 unit 사용량과 호출 수를 확인합니다. 고객 시스템의 로그와 대조할 때도 요청 시각을 KST로 맞춥니다.

  3. 에셋과 API 키 비교하기

    에셋별 표에서 모델 사용 비중을, API 키별 표에서 호출에 사용된 키를 확인합니다. 호출한 시스템을 확인하려면 키 이름과 고객 시스템의 사용처 기록을 대조합니다.

요청별 비용과 잔액 확인하기

분석 화면의 누적 사용량(unit)은 호출 한 건의 비용이나 남은 잔액이 아닙니다. 값별 확인 위치와 unit, USD 및 KRW 값을 대조하는 조건은 요금 및 사용량 안내에서 확인합니다.

콘솔 없이 서버에서 조회하기

서버에서 조회하려면 별도의 관리 API 키로 관리 API를 호출합니다. 관리 API의 월별 비용은 USD이므로 분석 화면의 unit 값과 바로 비교할 수 없습니다. 서버에서 비용과 사용량을 기록하는 방법은 요금 및 사용량 안내에서 확인합니다.

데이터가 보이지 않거나 다를 때

증상다음 행동
기간을 바꿨지만 이전 값이 남아 있음조회가 끝난 뒤 표시된 값이 선택한 기간의 결과인지 확인합니다. 오류가 표시되면 기간을 다시 선택합니다.
조회에 실패했다는 오류가 표시됨이 오류는 사용량 0을 뜻하지 않습니다. 기간을 다시 선택하고, 계속 실패하면 아래 정보로 문의합니다.
호출 직후 값이 보이지 않음잠시 후 새로고침하고 월별 또는 일별 기준, 현재 스페이스와 API 키를 다시 확인합니다.
값이 비어 있거나 0으로 보임빈 값이나 0만으로 해당 기간에 사용이 없었다고 확정하지 않습니다. 월별 또는 일별 기준, 현재 스페이스와 조회할 수 있는 키를 확인하고 최근 호출은 잠시 후 다시 조회합니다.
응답의 호출 비용과 누적값이 다름한 건의 비용과 누적 집계는 범위 및 반영 시점이 다릅니다. 요청별 비용의 기록 시점을 확인합니다.

고객 시스템의 호출 기록과 계속 다르면 플랫폼 내 문의 기능에 스페이스 이름, 조회 기간, API 키 이름과 오류 내용을 남깁니다. API 키 값은 보내지 마세요.