개요
API 사용량은 두 가지 방법으로 확인할 수 있습니다.
분석 > 사용량에서 현재 및 과거 보고 기간의 API 활동을 확인하세요.
API 응답의 사용량 정보를 읽어 개별 요청을 확인하세요.
Playground는 애플리케이션과 동일한 API 호출을 사용합니다. Playground에서 사용한 토큰은 계정의 API 사용량에 포함되며 동일한 사용 규칙과 요금이 적용됩니다.
대시보드 액세스
사용량 대시보드에 액세스하려면 조직 소유자이거나 사용량 대시보드 권한이 있어야 합니다.
대시보드에서 사용량 확인
API 플랫폼에서 분석을 열고 사용량을 선택해 현재 프로젝트를 확인하세요. 조직 전체 보고서를 보려면 조직 분석을 선택하세요. 확인할 보고 기간을 선택하고, 프로젝트 분석과 조직 분석 간에 전환한 후에는 기간을 다시 확인하세요.
대시보드 데이터는 UTC 기준으로 표시됩니다. 대시보드의 활동과 애플리케이션 로그를 비교할 때는 이 시간대를 고려하세요.
최근 사용량이 대시보드에 표시되기까지 시간이 걸릴 수 있습니다. 최근 활동이 표시되지 않으면 나중에 다시 확인하세요.
사용량 필터링
프로젝트 분석에는 선택한 프로젝트의 사용량만 표시됩니다. 조직 분석에서는 프로젝트에서 확인할 프로젝트를 선택하세요. 모든 프로젝트에는 조직의 모든 프로젝트가 포함되며, 선택한 다른 필터도 적용됩니다.
필터를 사용해 API 소스, API 키, 모델, 사용자, 처리 등급별로 사용량 범위를 좁히세요. API 소스에서는 모든 API 소스, Agents API, 직접 API 중에서 선택할 수 있습니다.
선택 항목을 개별적으로 해제하거나 필터 지우기를 선택해 필터 패널을 초기화하세요. 필터를 지워도 프로젝트 분석과 조직 분석 간에 화면이 전환되지는 않습니다.
사용량 차트의 필터를 사용해 배치 기준으로 필터링하세요. 차트 필터 초기화를 선택하면 해당 차트의 필터가 초기화됩니다.
기능이 선택한 필터를 지원하지 않으면 해당 값이 표시되지 않을 수 있습니다. 값이 표시되지 않는다고 해서 사용량이 0인 것은 아닙니다.
필터에 권한 오류가 표시되면 해당 필터의 옵션에 접근할 권한이 없을 수 있습니다. 이는 사용량이 기록되지 않았다는 의미가 아닙니다.
개별 사용자의 사용량 확인
확인하려는 프로젝트 또는 조직의 분석 화면에서 사용량을 여세요. API 기능 표에서 Responses 및 Chat Completions의 보기를 선택하세요.
필터에서 사용자를 선택한 다음 해당 사용자를 선택하세요. 결과가 즉시 업데이트됩니다.
해당 사용자의 차트와 표를 확인하세요.
사용자의 사용량을 여러 기능에 걸쳐 확인하려면 사용량 개요에서 사용자 필터를 적용하세요. 사용자 간에 비교하려면 해당 필터를 지우고 표의 사용자 탭을 선택하세요.
일별, 시간별, 분별 토큰 수 확인
사용량에서 시간 간격을 설정할 수 있는 경우, 1일 또는 1시간을 선택해 일별 또는 시간별 토큰 수를 확인하거나 1분을 선택해 분당 토큰 수(TPM)를 살펴보세요. 자동을 선택하면 대시보드가 보고 기간에 맞는 시간 간격을 선택합니다. 이 간격은 사용량 데이터에 적용되며 청구 데이터에는 적용되지 않습니다.
1분이 비활성화되어 있다면 더 짧은 보고 기간을 선택하거나 영역 선택으로 확대를 사용해 차트를 드래그하여 범위를 좁히세요. 그런 다음 1분을 선택하세요. 확대 영역 선택을 취소하려면 Esc를 누르세요. 다른 보고 기간을 선택하려면 분석 도구 모음에서 현재 날짜 범위를 선택하세요.
사용량 차트 및 표 확인
지표에서 함께 표시할 데이터 계열을 하나 이상 선택하세요. 입력 토큰, 캐시되지 않은 입력 토큰, 캐시된 입력 토큰, 캐시 쓰기 입력 토큰, 입력 오디오 토큰, 출력 토큰, 출력 오디오 토큰 등을 선택할 수 있습니다. 사용 가능한 지표는 기능에 따라 다릅니다. 범례에서 각 데이터 계열을 확인하세요.
그룹화 기준을 사용하면 프로젝트, 사용자, 모델 등 사용 가능한 범주별로 사용량을 정리할 수 있습니다. 필터는 포함할 사용량을 결정하고, 그룹화는 표시 방식을 결정합니다. 추세를 살펴보거나 범주를 비교하려면 꺾은선 차트와 막대 차트를 전환하세요.
사용량 표의 탭에서 제공되는 세부 내역을 확인하세요. 표의 각 행에는 요청 수, 입력 및 출력 토큰 수, 기능별 단위 등 관련 측정값이 표시됩니다.
API 기능에서 확인할 기능의 보기를 선택하면 상세 차트와 세부 내역이 열립니다. Responses 및 Chat Completions에는 별도의 토큰 차트와 요청 차트, 모델 요청 지표가 포함되어 있습니다. 세부 내역 탭은 개요와 동일한 분류 기준을 사용하며, API 기능 탭은 제외됩니다. 탐색 경로의 사용량을 선택하면 개요로 돌아갑니다.
그룹화 기준 옵션을 선택하면 차트에서 추가 범주가 기타로 묶여 표시될 수 있습니다. 차트 범례에 기타가 표시되면 해당 레이블을 선택해 포함된 범주와 각 사용량을 확인하세요.
대시보드 비교를 선택하면 동일한 보고 기간의 사용량과 다른 대시보드를 나란히 볼 수 있습니다. 왼쪽 대시보드와 오른쪽 대시보드에서 표시할 화면을 선택하세요. 선택한 시간 간격을 두 대시보드에서 함께 사용할 수 없으면 자동으로 전환됩니다. 비교 종료를 선택하면 대시보드로 돌아갑니다.
출처를 알 수 없는 사용량 조사
사용량에 표시된 활동과 일치하는 요청을 애플리케이션 로그에서 찾을 수 없다면 다음 사항을 확인하세요.
조직, 프로젝트 범위, 보고 기간을 확인하세요. 대시보드의 타임스탬프와 애플리케이션 로그를 비교할 때는 UTC를 기준으로 하세요.
해당 프로젝트의 프로젝트 보기를 사용하거나, 조직 분석의 프로젝트에서 해당 프로젝트를 선택하세요. 그런 다음 필터에서 API 키와 모델별로 사용량 범위를 좁히고, 더 짧은 보고 기간을 선택하세요.
동일한 기간, 프로젝트, API 키에 해당하는 로그와 활동을 비교하세요. 해당 키를 사용하는 모든 애플리케이션이나 연동 서비스의 기록이 로그에 포함되어 있는지 확인하세요.
여러 애플리케이션이나 연동 서비스가 동일한 프로젝트 또는 API 키를 공유한다면, 총사용량만으로는 어디서 요청을 보냈는지 파악하기 어려울 수 있습니다. 동일한 UTC 기간을 기준으로 대시보드와 각 애플리케이션의 기록을 비교하세요.
그래도 사용량의 출처를 파악할 수 없다면 해당 UTC 기간, 조직 및 프로젝트 ID, API 키 식별자, 관련 스크린샷이나 로그를 첨부하여 OpenAI 지원팀에 문의하세요. 요청 ID가 있다면 함께 첨부하세요. 비밀 API 키는 포함하지 마세요.
사용량 데이터 내보내기
사용량을 내보내려면 분석 도구 모음에서 CSV 내보내기 아이콘을 선택한 다음 활동 데이터를 선택하세요.
API 기능과 하나 이상의 그룹화 기준을 선택하세요.
API 소스, 프로젝트, 사용자, API 키, 모델을 확인하세요. 프로젝트와 API 소스에는 분석에서 선택한 값이 미리 적용됩니다. 나머지 내보내기 필터는 대화 상자에서 선택하세요.
파일 형식, 시작 시간, 종료 시간, 시간 간격을 선택한 다음 다운로드를 선택하세요. 선택한 날짜에는 UTC 기준 하루 전체가 포함됩니다.
달력 기준 1년 전 오늘의 00:00 UTC부터 오늘까지의 활동 및 비용 데이터를 조회하고 내보낼 수 있습니다. 그 이전 데이터가 필요하면 OpenAI 지원팀에 문의하세요. 일별 데이터는 31일 단위로 나뉜 파일로 내보내집니다.
월별 청구서 대조 및 세부 항목 내보내기는 월별 사용량 세부 정보 내보내기를 참고하세요.
내보낸 활동 데이터에 음수 값이 있는 행이 포함되어 있다면 단위, 그룹화 기준, 날짜가 같은 행끼리 비교하세요. 청구 금액은 비용 데이터에서 확인하세요. 활동 데이터에 음수 값이 있는 행이 있다고 해서 청구 금액이 차감되었다고 단정할 수는 없습니다.
지출 확인
분석을 열고 지출을 선택해 현재 프로젝트의 비용을 확인하세요. 조직 전체 비용을 보려면 조직 분석을 선택한 다음 지출을 선택하세요.
비용과 사용량을 비교하기 전에 현재 날짜 범위와 필터를 확인하세요. 사용량과 지출에서 제공하는 필터는 서로 다릅니다. 한 대시보드에서 사용할 수 있는 필터가 다른 대시보드에는 적용되지 않을 수 있습니다.
API 소스, API 키, 모델, 세부 항목을 사용해 지출 범위를 좁히세요. 조직 분석에서는 프로젝트에서 확인할 프로젝트를 포함하세요. 표의 세부 항목, API 키, 사용자, 프로젝트, 모델 탭에서 제공되는 세부 내역을 확인하세요.
지출 한도 값이 표시되지 않는다고 해서 한도가 0이거나 새로운 한도가 적용되었다는 의미는 아닙니다. 접근 권한, 한도 미설정, 요청 실패 등의 이유로 대시보드에 값이 표시되지 않을 수 있습니다.
서비스 상태 확인
조직에 서비스 상태 접근 권한이 있다면 분석에서 해당 대시보드를 열어 API 성능을 확인하세요. 이용 자격 및 지표 정의는 API 오류 및 지연 시간 문제 해결을 참고하세요.
지급된 크레딧 확인
지급된 크레딧의 세부 정보는 조직의 청구 페이지에서 확인할 수 있습니다.
지급된 크레딧과 API 사용량은 서로 다른 정보를 제공합니다. 지급된 크레딧에서는 조직에 연결된 크레딧을, 사용량에서는 조직의 API 활동을 확인할 수 있습니다.
스케일 등급 사용량 및 비용 검토
조직에서 스케일 등급이 활성화되어 있고 필요한 액세스 권한이 있다면 스케일 등급 사용량 페이지를 열어 자세한 사용량을 확인하세요.
스케일 등급 번들 비용은 개별 프로젝트가 아닌 조직에 귀속됩니다.
사용량은 0보다 크지만 프로젝트 지출은 0인 경우
해당 모델의 사용량이 스케일 등급 할당량에 포함되는지 확인하세요. 해당 모델의 모든 사용량이 스케일 등급 TPM 할당량 이내라면 프로젝트에 추가 모델 지출 없이 사용량만 표시될 수 있습니다.
스케일 등급 구독 비용은 조직 수준에 그대로 반영됩니다. 개별 프로젝트의 지출만으로 판단하지 말고 조직 전체 지출을 확인하세요.
여러 조직 확인
사용량 대시보드는 여러 조직의 비용 또는 사용량 데이터를 합산하지 않습니다. 하위 조직을 포함한 각 조직은 별도로 처리됩니다.
하위 조직을 보려면 조직 선택기에서 해당 조직을 선택하세요.
통합 보고서가 필요하다면 별도의 하위 조직 대신 하나의 조직 내에서 프로젝트를 사용하는 방안을 고려하거나, Usage API를 사용해 맞춤 분석을 수행하세요.
API 응답에서 토큰 사용량 확인
토큰 사용량 필드 이름은 엔드포인트에 따라 다릅니다.
| 토큰 수 | Chat Completions | Responses |
|---|---|---|
| 입력 토큰 | usage.prompt_tokens | usage.input_tokens |
| 출력 토큰 | usage.completion_tokens | usage.output_tokens |
| 총 토큰 | usage.total_tokens | usage.total_tokens |
Chat Completions 응답에는 토큰 사용량 정보가 포함될 수 있습니다. 예시는 다음과 같습니다.
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}엔드포인트와 모델에 따라 사용량 세부 내역에 캐시된 입력 토큰 수와 추론 토큰 수가 포함될 수도 있습니다. 이러한 항목을 보면 눈에 보이는 응답 길이만으로는 전체 토큰 사용량을 알 수 없는 이유를 이해할 수 있습니다.
각 토큰 유형에 대한 설명은 토큰 이해 및 계산을 참조하세요.
토큰 사용량을 보고하는 전사 응답에서는 오디오 및 텍스트 입력 토큰이 이미 input_tokens에 포함되어 있습니다. 이 항목들을 입력 토큰 합계에 다시 더하지 마세요. output_tokens는 별도로 비교하세요.
Chat Completions 스트리밍 응답에서 사용량 확인하기
Chat Completions 스트리밍 요청에 다음을 포함하세요:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}include_usage를 활성화하면 data: [DONE] 앞에 전체 요청의 사용량이 담긴 청크가 추가됩니다. 이 청크의 choices 배열은 비어 있습니다. 다른 청크의 usage 값은 null입니다.
스트림이 중단되면 마지막 사용량 청크를 받지 못할 수 있습니다. 마지막 청크를 받지 못했다고 해서 해당 요청이 토큰을 사용하지 않았다고 단정할 수는 없습니다.
이 설정은 Chat Completions에만 적용됩니다. 자세한 내용은 Chat Completions API 참조 문서를 확인하세요.
