
오픈소스 도구 ai-bill-to-focus는 Anthropic과 OpenAI 등의 AI 서비스 비용 내역을 FinOps FOCUS 1.4 CSV로 변환하고, CSV가 FOCUS 1.2·1.3·1.4 규칙에 맞는지 검사한다. 파일은 사용자 기기에서 처리되며 업로드되지 않는다.
Anthropic은 Claude Console의 Cost 내보내기 파일과 토큰 수량이 담긴 Usage 내보내기 파일을 함께 사용할 수 있다. 실제 Console 내보내기로 테스트했다. OpenAI는 비용 데이터와 Completions 활동 내보내기를 사용하며, Together AI는 비용 분석 CSV를 지원하지만 두 변환기는 실제 내보내기 파일로 아직 테스트되지 않았다.
npx ai-bill-to-focus convert cost.csv usage.csv -o focus.csv --check
변환 결과는 날짜·모델·토큰 유형별로 한 행씩 기록한다. 입력 토큰, 캐시 쓰기·읽기, 출력 토큰을 각각 구분하며, BilledCost에는 제공업체의 달러 금액을 유지한다. Anthropic은 두 종류의 내보내기 파일이 있을 때 공개 가격을 적용한 토큰 비용이 Cost 파일의 센트 단위 금액으로 반올림해 일치하는 경우에만 그 계산값을 쓴다. 그렇지 않으면 제공업체가 반올림해 기록한 금액을 사용하며, 적용한 가격 출처는 x_PriceSource에 표시한다.
도구는 CSV 헤더를 바탕으로 제공업체와 파일 역할을 판별하므로 입력 파일 순서는 상관없다. 인식되지 않는 파일은 ai-bill-to-focus detect <file>로 확인할 수 있다. FOCUS 표준에 없는 제공업체 정보는 x_ 열에 보존하고, 태그는 표준에 맞춰 하나의 JSON 열에 담는다.
검사 기능은 FinOps Foundation의 규칙 모델을 자바스크립트로 옮겨 열 존재 여부와 형식, 허용 값, 열 간 규칙 등을 확인한다. 전체 검증기가 필요한 동적 규칙 등은 통과로 간주하지 않고 미검사 항목으로 집계한다. 따라서 파일을 인증하려면 공식 검증기도 실행해야 한다. 종료 코드는 정상일 때 0, FOCUS 오류나 변환 실패 시 1, 잘못된 사용법일 때 2이며, check를 CI 검사 단계에 사용할 수 있다.
Anthropic·OpenAI 변환은 공개 모델 가격표를 내려받기 위해 https://api.cognocient.com/api/estimate/models에 요청한다. 이 요청에는 사용자 파일 정보가 포함되지 않는다. --offline을 지정하면 네트워크 요청을 건너뛰며, 이 경우 Anthropic 토큰 행의 단가는 공개 가격 대신 제공업체의 반올림된 비용을 바탕으로 계산한다. --prices file.json으로 같은 형식의 가격표를 직접 제공할 수도 있다. check, detect, Together AI 변환은 네트워크 요청을 하지 않는다.
같은 변환기와 검사기는 웹 도구에서도 실행할 수 있다. 소스 코드는 GitHub 저장소에서 확인할 수 있으며, 라이선스는 MIT다. 이 프로젝트는 FinOps Foundation과 제휴하거나 승인을 받은 것이 아니라고 밝히고 있다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요