API 사용량 측정 — 요청·토큰·도구 비용 구분

API 사용량은 청구서 총액만 보면 원인을 찾기 어렵습니다. 요청 수, 입력 토큰, 출력 토큰, 캐시, 도구 호출을 따로 모아야 합니다. 가장 작은 단위인 한 요청부터 기록하면 모델 변경과 코드 오류가 비용에 미친 영향을 구분할 수 있습니다.

이 글의 요금·조건은 2026년 9월 14일에 각 서비스 공식 페이지에서 확인한 값입니다. 이후 변경됐을 수 있습니다.

어느 값을 한 줄에 담나요?

시각, 프로젝트, 기능, 모델, 성공 여부, 입력과 출력 사용량을 한 행으로 남깁니다. 재시도 횟수와 도구 호출도 별도 열로 둡니다. 사용자의 원문이나 API 키는 비용 로그에 넣지 않습니다. 요청 식별자를 보관하면 사업자 콘솔과 맞춰 볼 때 도움이 됩니다. 금액은 응답 시점의 요율표를 적용해 계산합니다.

응답과 콘솔은 왜 함께 보나요?

응답의 usage는 개별 호출을 설명하고 콘솔은 계정에 누적된 결과를 보여줍니다. 스트리밍 중단이나 비동기 작업은 앱이 본 결과와 청구 시점이 다를 수 있습니다. 하루 합계를 비교하되 몇 분의 반영 지연은 구분합니다. 계속 차이가 나면 숨은 재시도와 다른 프로젝트 키부터 찾습니다.

실패 요청도 비용이 드나요?

오류 종류와 사업자 정책에 따라 다릅니다. 네트워크에서 요청이 끊겼어도 서버에서는 처리가 끝났을 수 있습니다. 앱 로그의 실패라는 표지만으로 무료라고 판단하지 않습니다. 같은 요청 식별자가 여러 번 생겼는지 보고, 공식 청구 설명에서 실패 상태의 처리 기준을 확인합니다.

그래프는 어떤 단위로 나누나요?

처음에는 시간당 요청 수와 토큰을 같이 봅니다. 요청은 그대로인데 토큰만 늘면 대화 이력이나 문서가 길어진 상황일 수 있습니다. 출력만 늘면 종료 조건과 최대 길이를 확인합니다. 요청 수가 튀면 재시도, 예약 작업, 외부 호출을 살핍니다. 금액 그래프 하나보다 원인 단위 세 개가 더 유용합니다.

개인정보 없이 측정하려면 어떻게 하나요?

콘텐츠 대신 길이와 토큰 수, 기능 이름만 수집합니다. 사용자 ID가 필요하면 서비스 내부의 무작위 식별자를 쓰고 보관 기간을 정합니다. 비용 분석에 필요 없는 프롬프트와 응답을 장기 저장하지 않습니다. 2026년 9월 14일 Anthropic 관리 API 문서는 조직의 사용량과 비용을 시간·모델·워크스페이스 차원으로 조회하는 방법을 제공합니다.

확인한 공식 원문

• Anthropic Usage and Cost API — 2026년 9월 14일 확인
• OpenAI Usage API 참고 — 2026년 9월 14일 확인