Copilot 사용량 API: BYOK 집계에서 중복 합산을 피하는 법
GitHub Copilot 사용량 지표 API에서 자체 키 사용(BYOK)과 기업용 사용자 지정 모델의 사용량을 구분할 수 있습니다. 팀의 AI 사용 현황을 확인하는 관리자에게 도움이 될 만한 변경입니다.
로컬 BYOK는 개발자가 클라이언트에서 설정합니다. 요청은 Copilot CLI 또는 GitHub Copilot 앱에서 개발자의 제공업체나 로컬 모델로 직접 전달됩니다. 사용자별 사용 여부는 used_local_byok, 사용량 집계는 totals_by_local_byok에서 확인합니다.
기업용 사용자 지정 모델은 관리자가 GitHub 설정에서 구성하고, 요청은 GitHub를 거쳐 제공업체로 전달됩니다. 해당 모델 여부는 totals_by_client[].totals_by_model[] 안의 is_custom_enterprise_model로 구분합니다.
집계할 때는 중복 합산을 주의해야 합니다. 로컬 BYOK는 기존 CLI·앱 합계의 일부이고, 기업용 사용자 지정 모델도 기존 totals_by_client에 이미 포함돼 있습니다. 새 항목을 기존 합계에 다시 더하는 방식으로 읽으면 안 됩니다.
수치의 한계도 있습니다. 로컬 BYOK는 클라이언트 텔레메트리가 꺼져 있거나 제공업체가 토큰 사용량을 보내지 않으면 실제보다 적게 집계될 수 있습니다. 서버에서 관측하는 기업용 사용자 지정 모델 집계에는 이 텔레메트리 한계가 적용되지 않습니다.
누구나 바로 조회할 수 있는 기능은 아닙니다. 공식 안내는 기업 소유자·기업 결제 관리자·조직 소유자 또는 View Copilot Metrics 권한을 가진 사용자로 접근을 제한하며, Copilot 사용량 지표 정책도 활성화돼 있어야 한다고 설명합니다.
실무에서는 먼저 조회 권한과 정책을 확인하고, 기존 합계에 포함된 세부 항목인지 살펴보는 순서가 좋겠습니다. 이 순서는 공식 집계 조건을 바탕으로 한 편집 제안이며, 비용 절감이나 사용량 증가를 입증한 결과는 아닙니다.