AI API 비용 추적기: 헤더로 지출 모니터링
모든 응답에 잔액 정보가 포함되어 있으므로 약 50줄로 비용 추적기를 구축할 수 있습니다. 이 가이드는 요청별 지출 로깅, 잔액 엔드포인트 읽기 및 크레딧 소진 전 알림 발생 방법을 보여줍니다.


주요 포인트
- 모든 응답에는 남은 크레딧을 나타내는 X-Balance-USD 헤더가 포함됩니다.
- GET /v1/balance 및 credit_grants 엔드포인트는 요청 시 잔액을 반환합니다.
- 호출당 비용은 (입력 x 0.15 + 출력 x 0.50) / 1,000,000 달러입니다.
- CSV에 로깅하고 잔액이 임계값 아래로 떨어지면 알림을 발생하세요.
숫자의 출처
선불 크레딧은 공급자가 이미 합계 잔액을 유지하므로 비용 추적을 단순하게 만듭니다. 다음 세 가지 위치에서 확인할 수 있습니다:
- API 호출 시 요청 후 남은 금액을 보여주는
X-Balance-USD응답 헤더 GET /v1/balance, 단순 잔액 조회입니다.GET /v1/dashboard/billing/credit_grants, 대시보드 및 래퍼와 같은 도구가 이미 호출 방법을 알고 있는 OpenAI 스타일 경로
그 외에도 각 완료 응답에는 usage 객체가 포함되어 프롬프트 및 완료 토큰 수가 포함됩니다. 토큰을 가격($0.15/1M 입력 토큰, $0.50/1M 출력 토큰)과 결합하면 모든 요청의 비용을 직접 계산할 수 있으며, 잔액 감소액과 비교할 수 있습니다. 두 값은 일치해야 합니다. 일치하지 않으면 조사가 필요한 항목을 찾은 것입니다. 전체 사용량 세부 정보는 docs에서 확인할 수 있습니다.
한 번의 요청으로 헤더 읽기
curl을 사용할 때 -i를 추가하고 헤더를 확인하세요:
curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
| grep -i "x-balance-usd"
Python에서 OpenAI SDK는 with_raw_response를 통해 원본 응답을 노출하며, 이를 통해 헤더와 파싱된 객체를 함께 얻을 수 있습니다:
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
raw = client.chat.completions.with_raw_response.create(
model="uncensored",
messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)모든 호출을 기록하는 작은 로거
호출을 하나의 함수로 감싸고 매번 CSV 행을 작성하세요. 행에는 시간, 요청 ID, 토큰 수, 계산된 비용 및 잔액이 포함됩니다.
import csv, time
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50 # dollars per 1M tokens
LOG = "api_spend.csv"
def cost(usage):
return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000
def tracked_chat(messages, tag="default"):
raw = client.chat.completions.with_raw_response.create(
model="uncensored", messages=messages)
r = raw.parse()
row = [
time.strftime("%Y-%m-%d %H:%M:%S"),
raw.headers.get("x-request-id"),
tag,
r.usage.prompt_tokens,
r.usage.completion_tokens,
round(cost(r.usage), 6),
raw.headers.get("x-balance-usd"),
]
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow(row)
return r, row
tag 인자는 로그를 유용하게 만드는 핵심입니다. "summaries" 또는 "chat"과 같은 기능 이름을 전달하면 나중에 태그별 비용 합계를 통해 제품의 어느 부분이 비용을 많이 발생시키는지 확인할 수 있습니다. 요청 ID는 특정 호출을 식별하므로 요금에 대한 문의나 문제 보고 시 도움이 됩니다.
수학 계산의 타당성 확인
입력 토큰 2,400개와 출력 토큰 600개로 호출을 수행하세요:
- 입력: 2,400 x 0.15 / 1,000,000 = $0.00036
- 출력: 600 x 0.50 / 1,000,000 = $0.00030
- 합계: $0.00066
이러한 호출 1,000개의 비용은 $0.66입니다. CSV에서 잔액이 계산된 비용 합계보다 훨씬 빠르게 감소한다면 로깅하지 않은 재시도, 동일한 키를 사용하는 백그라운드 작업 또는 닫지 않은 스트림을 확인하세요. 실패하거나 거부된 요청에는 요금이 부과되지 않으므로 오류는 잔액에 영향을 주지 않아야 합니다. 작은 반올림 오차가 상쇄되도록 단일 호출이 아닌 여러 호출에 대한 합계를 비교하세요.
스트리밍 호출 및 사용량
stream: true를 사용하면 사용량 정보가 스트림 끝에 도착합니다. 마지막 청크에서 수집한 후 스트림이 닫힌 후에 행을 로깅하세요.
def tracked_stream(messages, tag="chat"):
usage = None
for chunk in client.chat.completions.create(
model="uncensored", messages=messages, stream=True):
if chunk.choices and chunk.choices[0].delta.content:
yield chunk.choices[0].delta.content
usage = getattr(chunk, "usage", None) or usage
if usage:
with open(LOG, "a", newline="") as f:
csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])
잔액만 필요하면 스트림이 끝난 후 GET /v1/balance를 호출하세요. 이는 비용이 적게 드는 요청이며 cron 작업에서 주기적으로 확인하는 데에도 사용할 수 있습니다.
기능별 지출 합산
CSV는 읽을 때만 유용합니다. 이 짧은 스크립트는 태그별 비용 합계를 계산하고 추가 패키지 없이 최신 잔액을 표시합니다.
import csv
from collections import defaultdict
totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
for row in csv.reader(f):
ts, req_id, tag, pin, pout, cost_usd, balance = row
totals[tag] += float(cost_usd)
last_balance = balance or last_balance
for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)
매일 실행하고 출력을 팀 채널에 붙여넣으세요. 보이지 않던 지출이 사람들이 논의할 수 있는 숫자가 되고, 다른 기능보다 10배 더 비싼 기능이 즉시 드러납니다. 대략적인 예산을 위해서는 일일 합계에 30을 곱하고 여유 공간 20%를 추가하세요.
잔액 부족 알림 추가
낮 중 크레딧이 부족해지면 제품이 중단되므로 조기에 알림을 발생하세요. 15분마다 실행되는 cron 작업이면 충분합니다.
import requests
BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00 # dollars
r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text) # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.
파싱 코드를 작성하기 전에 원본 JSON을 한 번 출력하고 확인하세요. 실제 필드 이름을 확인하는 데는 10초가 걸리며, 기사에서 추측하면 경고를 알리지 않고 실패할 수 있습니다. 정상적인 하루 사용량을 커버할 수 있는 임계값을 선택하세요. CSV 파일에서 어제의 비용을 합산하여 최소값으로 사용하세요.
알림이 발생하면 충전하세요. $20에서 $500 사이의 전체 금액이 모두 유효하며, $50 이상 충전 시 +5%, $100 이상 충전 시 +10%, $200 이상 충전 시 +15%의 크레딧 보너스가 제공되고 크레딧은 만료되지 않습니다. 추적기용 키를 먼저 얻으려면 API 키 페이지를 사용하세요.
지출을 예측 가능하게 유지하는 습관
- 환경별로 키를 하나씩 사용하여 테스트 트래픽이 프로덕션 데이터나 통계에 섞이지 않도록 하세요.
- 긴 답변이 필요 없는 엔드포인트에서
max_tokens을 제한하세요. 기본적으로 선택 사항이므로 제한 없는 응답이 가능합니다. - 채팅 기록을 정리하세요. 입력 토큰이 출력보다 저렴하지만, 매 턴마다 반복되는 긴 기록은 누적됩니다.
- 태그별 주간 합계를 검토하고 청구액의 절반 이상을 차지하는 태그를 확인하세요.
또 다른 습관: 모든 로깅 행에 요청 ID를 저장하세요. 한 달 후 숫자가 이상해 보일 때, 평균값으로 추측하며 논쟁하기보다 특정 호출과 일치시킬 수 있습니다. 실패한 요청에는 요금이 부과되지 않으므로 오류에 대한 재시도는 비용이 추가되지 않지만, 성공적인 답변 후 재시도는 비용이 추가되므로 재시도 로직이 실제 오류에서만 발생하도록 하세요. 성공한 요청을 루프에서 다시 보내는 버그는 토큰 기반 API에서 놀라운 청구서의 가장 흔한 원인입니다.
더 많은 가이드
질문과 답변
잔액 헤더가 모든 응답에 포함되나요?
X-Balance-USD 헤더는 이 API의 응답 헤더 목록에 포함되어 있습니다. 원본 응답에서 읽고, 값이 없으면 알 수 없는 것으로 처리하세요.
각 요청을 로깅하지 않고도 비용을 확인할 수 있나요?
네. GET /v1/balance를 일정 주기로 폴링하여 판독값 간의 차이를 계산하세요.
실패한 요청이 잔액에 영향을 미치나요?
아닙니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다.
기존 OpenAI 대시보드 도구는 어떤 엔드포인트를 사용해야 하나요?
많은 도구가 이미 지원하는 OpenAI 스타일 GET /v1/dashboard/billing/credit_grants 경로를 사용하십시오.