API 비용, 한 달에 한 번 보면 이미 늦는다
AI API 비용 모니터링 자동화하려고 이 글을 찾았다면, 지금쯤 “이번 달 청구가 왜 이렇게 나오지” 하는 상태일 확률이 높다. 나도 그랬다. 원클립AI에 AI 기능을 붙이고 한동안은 월말에 결제 명세서 열어 보고 “어? 지난달보다 많네” 하고 끝냈다. 어디서 샀는지, 어떤 기능 때문인지 명세서만 보면 안 나온다. 그때부터 세팅을 다시 짰다. 목표는 하나, 비용이 폭증하면 당일에 알아채는 것.
늦게 발견되는 패턴은 대체로 정해져 있다. 첫째는 월 단위로만 명세를 보는 습관. 둘째는 남은 일 수 확인을 안 하는 것. 셋째는 이상 징후가 있어도 어느 기능·어느 사용자 때문인지 로그가 없어 추적 자체가 안 되는 경우다. 나는 셋 다 겪었다.
STEP 1 – 매일 자동으로 API 비용을 기록하는 세팅
처음엔 제공사 콘솔에서 CSV를 수동으로 내려받아 스프레드시트에 붙여 넣었다. 3주쯤 버텼는데, 어느 날 새벽에 깨달았다. 내가 크론으로 블로그 글까지 하루에 쓰고 있는데 비용 기록만 손으로 하고 있다는 게 웃기더라. 그날 밤에 무인화했다.
구조는 단순하다. 새벽 크론이 제공사 usage API를 호출해서 어제 사용량을 긁어오고, DB 테이블에 한 줄 쌓는다. 지금 서버에 크론이 70개 돌고 있는데, 그중 하나가 이 일을 한다.
# 새벽 크론잡 예시 (crontab)
30 3 * * * /usr/bin/python3 /srv/cron/collect_api_usage.py >> /var/log/usage.log 2>&1
# 수집해서 쌓는 테이블 스키마
CREATE TABLE api_usage_daily (
date DATE NOT NULL,
provider VARCHAR(32), -- openai, elevenlabs 등
model VARCHAR(64),
tokens_in BIGINT,
tokens_out BIGINT,
cost_usd DECIMAL(10,4),
cost_krw DECIMAL(12,2), -- 그날 환율로 환산
PRIMARY KEY (date, provider, model)
);
달러만 적으면 감이 안 온다. 환산한 원화까지 같이 적는 게 체감이 달랐다. 날짜, 모델, 토큰, 달러, 원화. 이 다섯 개면 나중에 어떤 분석이든 붙일 수 있다.
STEP 2 – 임계값을 넘으면 즉시 알림 받는 법
기록만 하면 결국 그것도 몇 달에 한 번 열어보는 데이터일 뿐이다. 임계값을 걸고 알림을 붙였다.
| 단계 | 조건 | 액션 |
|---|---|---|
| 주의 | 일일 비용이 최근 7일 평균보다 크게 오름 | 슬랙 알림 1회 |
| 경고 | 주간 누적이 예산의 절반을 넘음 | 슬랙 + 카카오톡, 1시간 간격 재체크 |
| 정지 | 월 예산 상한 도달 | 알림 + 해당 기능 호출 자동 중단 |
처음엔 임계값을 너무 높게 잡았다. 알림이 와도 이미 늦은 상태라 의미가 없었다. 기준을 바꿨다. 절대값이 아니라 일일·주간 이동평균 대비 변화로 잡으니 잡음도 줄고 폭증도 잡혔다.
def check_and_alert(today_cost, window_avg, slack_webhook):
if today_cost > window_avg * 3:
requests.post(slack_webhook, json={
"text": f"API 일일 비용 이상: ${today_cost} (7일 평균 ${window_avg})"
})
return True
return False
웹훅은 슬랙이 제일 편했다. 카카오톡은 세팅할 게 좀 더 많은데, 휴대폰으로 바로 오니 정지 단계에 붙였다. 이렇게 하고 나서 “며칠 전에 새기 시작한 걸 오늘 발견”하는 일은 없어졌다.

STEP 3 – 무료 사용자 남용 잡아내고 자동으로 차단하기
폭증 원인은 대체로 삼형제다. 남용, 버그, 키 유출. 구분법부터 정리했다.
| 원인 | 로그상 특징 |
|---|---|
| 남용 | 특정 계정·IP의 요청이 유독 많고 토큰 소비가 큼 |
| 버그 | 내 서비스 로직상 재시도·루프로 같은 요청 반복 |
| 유출 | 내 서비스 유입과 무관한 요청이 새벽 등 이상한 시간대에 집중 |
원클립AI에서 무료 체험을 반복해서 가입하는 패턴이 잡힌 적이 있다. 요청 로그를 사용자 단위로 붙여 놓으니 바로 보였다. 그때 막은 게 레이트리밋과 일일 쿼터다. 무료 사용자는 하루 요청 수에 상한을 두고, 넘으면 그날은 자동으로 호출이 막히게 했다. 차단한 뒤 일일 비용 그래프가 눈에 띄게 내려앉았다.
그리고 구조 자체를 바꿨다. API 키를 클라이언트에 두지 않고 내 서버에만 둔다. 프론트는 내 서버에 요청하고, 서버가 키로 제공사를 호출한다. 남용 방지와 키 유출 예방이 한 번에 되는 구조라 이건 처음부터 이렇게 했어야 했다.

STEP 4 – 사용자별·기능별 원가 계산 구조 만들기
기록에 메타데이터를 태깅하면 원가 계산이 된다. 요청 하나에 사용자 아이디와 기능명을 붙이는 것뿐이다.
{“user_id”: “u_123”, “feature”: “shorts_script”, “model”: “gpt-4o-mini”, “tokens_in”: 812, “tokens_out”: 1400, “usd”: 0.0031, “ts”: “2026-10-21T03:40:12Z”}
이 태그를 달아 두면 월 말에 기능별로 묶어서 집계하면 된다.
SELECT feature, COUNT(*) AS calls, SUM(usd) AS cost
FROM request_log
WHERE ts >= '2026-10-01'
GROUP BY feature
ORDER BY cost DESC;
이 실측 데이터로 유료 플랜 가격을 다시 잡았다. 감으로 가격을 붙였을 때와 실측 원가를 보고 붙였을 때의 확신은 다르다. 원가가 생각보다 큰 기능이 있어서 그건 호출 방식을 손봤고, 원가가 거의 안 드는 기능은 무료로 풀었다. 실측이 먼저고 가격은 그 뒤다.

최악의 시나리오 – API 키 유출 예방과 대응
초기에 프론트엔드에서 API를 직접 호출하는 구조를 잠깐 고민한 적이 있다. 빨리 만들려면 그게 편하니까. 그런데 빌드된 코드에서 키가 사실상 노출된다는 걸 확인하고 서버 위임으로 돌렸다. 1인 운영이면 이 실수 하나로 시간당 청구가 폭증해도 막을 사람이 없다.
예방 체크리스트. 복붙해서 쓰면 된다.
- 키는 서버 환경변수에만. 코드·저장소에 커밋 금지
- 클라이언트는 내 서버 경유로만 제공사 호출
- 키에 사용량 상한과 만료일 설정이 되면 꼭 설정
- 사용처별로 키를 분리해 발급 (운영용, 테스트용 분리)
- 유출 확인 시: 해당 키 즉시 폐기, 새 키 발급, 환경변수 교체, 서버 재배포. 30분 안에 끝나는 절차를 미리 문서로 적어 둔다
폭증 알림이 키 유출 감지의 첫 신호가 되는 구조라 STEP 2와 연결된다. 알림 오면 먼저 유출부터 의심하고 키를 갈아치우는 순서로 드릴을 짜 둔다.
요약 – 오늘 하루면 끝내는 세팅 순서
- 제공사 usage API 확인
- 일별 수집 크론 등록
- 비용 기록 테이블 만들기
- 7일 이동평균 계산 로직 추가
- 슬랙 웹훅 발급
- 3단계 임계값과 알림 붙이기
- 요청 로그에 사용자·기능 태깅
- 무료 사용자 일일 쿼터 설정
- API 키 서버 위임 구조 점검
- 유출 대응 절차 문서화
지금 내 루틴은 주간 비용 리뷰 10분이다. 월요일에 슬랙으로 주간 요약이 오고, 이상 없으면 그걸로 끝. 나머지는 다 파이프라인이 본다.
한계도 적는다. 제공사 usage API는 집계 지연이 있어서 어제치가 당장 안 나올 때가 있다. 그래서 알림 기준을 하루 전 데이터로 잡았고, 그 시차 동안의 폭증은 STEP 3의 레이트리밋이 1차 방어선이다. 하나로 다 막는 세팅은 없고, 겹겹이 걸어 두는 수밖에 없다.
오늘 할 일은 하나면 된다. STEP 1, 새벽 크론 하나 붙이고 내일 아침에 기록이 쌓였는지 확인하는 것. 거기서부터 시작한다.
1인 빌더 아일리고가 씁니다. 잘된 것도 망한 것도 적습니다. 영상은 제가 만든 ClipSquare 에서 나옵니다.
자주 묻는 질문
AI API 비용 모니터링은 왜 매일 해야 하나요?
월 단위로 명세서만 보면 폭증 원인을 뒤늦게 발견하게 됩니다. 새벽 크론으로 제공사 usage API를 호출해 어제 사용량을 DB에 쌓으면, 비용이 이상하게 오르기 시작한 당일에 잡을 수 있습니다. 기록 항목은 날짜, 모델, 토큰, 달러, 원화 다섯 개면 충분합니다.
API 비용 알림 임계값은 어떻게 설정하는 게 좋나요?
절대값이 아니라 7일 이동평균 대비 변화율로 잡는 게 좋습니다. 일일 비용이 평균의 3배를 넘으면 주의, 주간 누적이 예산 절반을 넘으면 경고, 월 상한에 도달하면 자동 중단 3단계로 나누면 잡음도 줄고 폭증도 잡힙니다. 알림은 슬랙 웹훅이 세팅이 가장 간단합니다.
API 비용이 갑자기 폭증하는 원인은 보통 뭔가요?
남용, 버그, API 키 유출 셋 중 하나인 경우가 대부분입니다. 특정 계정·IP 요청이 유독 많으면 남용, 같은 요청이 반복되면 재시도 루프 버그, 새벽 같은 이상한 시간대에 서비스 유입과 무관한 요청이 몰리면 키 유출을 의심하면 됩니다.
무료 사용자의 API 남용은 어떻게 막나요?
요청 로그에 사용자 아이디를 붙여 남용 패턴을 먼저 확인한 뒤, 무료 사용자에게 일일 요청 상한(레이트리밋·쿼터)을 걸어 넘으면 자동으로 호출을 차단합니다. 추가로 API 키를 클라이언트가 아니라 서버에만 두면 키 유출 예방까지 한 번에 됩니다.
