개요
API 사용량은 다음 두 가지 방법으로 검토할 수 있습니다.
사용량 대시보드를 사용하여 현재 및 이전 청구 기간의 활동을 검토합니다.
개별 요청을 확인하려면 API 응답의 사용량 정보를 확인합니다.
Playground는 애플리케이션과 동일한 API 호출을 사용합니다. Playground에서 사용한 토큰은 계정의 API 사용량에 포함되며 동일한 사용량 규칙과 요금이 적용됩니다.
대시보드 액세스
사용량 대시보드에 액세스하려면 조직 소유자이거나 사용량 대시보드 권한이 있어야 합니다.
대시보드에서 사용량 검토
사용량 대시보드를 열고 검토할 조직을 선택한 다음 해당 보고 기간을 선택하세요.
대시보드 데이터는 UTC 기준으로 표시됩니다. 대시보드 활동을 애플리케이션 로그와 비교할 때 이 시간대를 고려하세요.
프로젝트 선택
대시보드에는 별도의 프로젝트 선택기가 있습니다. 이 선택기는 API 플랫폼의 다른 위치에서 선택한 프로젝트와 독립적으로 작동합니다.
대시보드의 선택기를 사용하여 하나, 여러 개 또는 모든 프로젝트를 검토하세요. 조직 전체 데이터를 보려면 선택한 프로젝트를 모두 해제하세요. 선택된 프로젝트가 없으면 대시보드에 모든 프로젝트 데이터가 표시됩니다.
개별 사용자의 사용량 검토
사용자 한 명의 Responses 및 Chat Completions 사용량을 검토하려면 다음 단계를 따르세요.
사용량 대시보드에서 API 기능 > Responses 및 Chat Completions로 이동합니다.
필터 기준을 선택합니다.
사용자에서 해당 사용자를 선택한 다음 필터 적용을 선택합니다.
분당 토큰 수 보기
사용량 세부 정보 페이지에서 간격을 선택할 수 있습니다. 분당 토큰 수(TPM)를 확인하려면 1분 간격을 선택하세요.
이 간격은 청구 데이터가 아닌 사용량 데이터에 적용됩니다.
사용량 데이터 내보내기
내보낼 수 있는 날짜 범위에는 제한이 없습니다. 기간이 긴 내보내기 데이터는 여러 파일로 분할될 수 있습니다.
월별 청구서 조정 및 항목별 내보내기에 관해서는 월별 사용량 세부 정보 내보내기를 참조하세요.
크레딧 지급 내역 보기
크레딧 지급 세부 정보는 조직의 결제 페이지에서 확인할 수 있습니다.
크레딧 지급 내역과 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 }} |
엔드포인트와 모델에 따라 사용량 세부 정보에 캐시된 입력 토큰 및 추론 토큰 수도 포함될 수 있습니다. 이 정보는 응답의 표시 길이만으로 전체 토큰 사용량을 알 수 없는 이유를 설명하는 데 도움이 됩니다.
다양한 토큰 카테고리에 관한 설명은 토큰 이해 및 계산을 참조하세요.
스트리밍된 Chat Completions에서 사용량 확인
스트리밍 Chat Completions 요청에는 다음을 포함하세요.
| { "stream": true, "stream_options": { "include_usage": true }} |
include_usage가 활성화되면 data: [DONE] 앞에 전체 요청의 사용량이 포함된 청크가 추가됩니다. 이 청크의 choices 배열은 비어 있습니다. 다른 청크의 usage 값은 null입니다.
스트림이 중단되면 이 최종 사용량 청크를 받지 못할 수 있습니다. 최종 청크가 없다고 해서 요청에서 토큰을 사용하지 않았다는 의미는 아닙니다.
이 구성은 Chat Completions에만 적용됩니다. 자세한 내용은 Chat Completions API 레퍼런스를 참조하세요.