AI API-kosten tracker: houd uitgaven bij met headers
Je kunt een ai api-kosten tracker bouwen in ongeveer 50 regels, omdat elk antwoord je al je resterende tegoed laat zien. Deze gids laat zien hoe je uitgaven per verzoek logt, de saldo-endpoints leest en een waarschuwing geeft voordat het tegoed op raakt.


Belangrijkste punten
- Elk antwoord bevat een X-Balance-USD header met je resterende tegoed.
- GET /v1/balance en het credit_grants-eindpunt geven het saldo op verzoek weer.
- De kosten per aanroep zijn (input x 0,15 + output x 0,50) / 1.000.000 dollar.
- Log naar CSV en waarschuw wanneer het saldo onder een drempelwaarde daalt.
Waar de cijfers vandaan komen
Prepaid tegoed maakt kostenregistratie eenvoudig, omdat de provider al een lopend totaal bijhoudt. Je krijgt het op drie plekken:
- De
X-Balance-USDantwoordheader bij API-aanroepen, die laat zien wat er na het verzoek nog over is. GET /v1/balance, een eenvoudige saldo-opvraging.GET /v1/dashboard/billing/credit_grants, de OpenAI-stijl route die tools zoals dashboards en wrappers al kennen.
Naast die gegevens bevat elk completion-object een usage-object met prompt- en completion-tokenaantallen. Combineer tokens met de prijzen ($0,15 per 1M invoer, $0,50 per 1M uitvoer) en je kunt de kosten van elk verzoek zelf berekenen, en dit vergelijken met de daling van het saldo. De twee moeten overeenkomen. Als dat niet zo is, heb je iets gevonden om te onderzoeken. Volledige parameterdetails staan in de docs.
Lees de header in één verzoek
Met curl, voeg -i toe en bekijk de headers:
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"
In Python exposeert de OpenAI SDK ruwe antwoorden via with_raw_response, wat je headers en het verwerkte object samen geeft:
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)Een kleine logger die elke aanroep registreert
Wikkel je aanroepen in één functie en schrijf een CSV-regel elke keer. De regel bevat de tijd, request ID, token-tellingen, berekende kosten en saldo.
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
Het tag argument is de truc die de log nuttig maakt. Geef een functienaam op zoals "samenvattingen" of "chat", en later kun je de kosten per tag optellen om te zien welk onderdeel van het product het geld verbruikt. De verzoek-ID helpt als je ooit over een factuur wilt vragen of een probleem wilt melden, omdat deze de exacte aanroep identificeert.
Controleer de berekening op plausibiliteit
Neem een gesprek met 2,400 input tokens en 600 output tokens:
- Input: 2.400 x 0,15 / 1.000.000 = $0,00036
- Output: 600 x 0,50 / 1.000.000 = $0,00030
- Totaal: $0.00066
Duizend daarvan kosten $0,66. Als je CSV-bestand laat zien dat het saldo veel sneller daalt dan de som van de berekende kosten, controleer dan op retries die je niet hebt gelogd, achtergrondtaken die dezelfde sleutel gebruiken, of streams die je open hebt gelaten. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus fouten mogen het saldo helemaal niet beïnvloeden. Vergelijk totalen over veel aanroepen, niet over enkele, zodat kleine afrondingsverschillen wegvallen.
Streamingaanroepen en gebruik
Met stream: true komen de usage-getallen aan het einde van de stream binnen. Verzamel ze uit de laatste chunk en log de rij nadat de stream is gesloten.
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), ""])
Als je alleen het saldo nodig hebt, roep dan GET /v1/balance aan na het einde van de stream. Het is een goedkoop verzoek en het werkt ook als periodieke controle vanuit een cronjob.
Uitgaven per functie optellen
De CSV is alleen nuttig als je hem leest. Dit korte script telt kosten per tag op en toont het laatste saldo, zonder extra pakketten.
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)
Voer het dagelijks uit en plak de uitvoer in je teamkanaal. Uitgaven die onzichtbaar waren, worden een nummer waarover mensen kunnen discussiëren, en een functie die tien keer meer kost dan de anderen valt direct op. Voor een ruwe begroting vermenigvuldig je het dagelijkse totaal met 30 en voeg je 20 procent marge toe.
Voeg een waarschuwing bij laag saldo toe
Als je tegoed op is tijdens de dag, valt het product offline, dus waarschuw vroeg. Een cronjob die elke 15 minuten draait, is genoeg.
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.
Print de ruwe JSON één keer en bekijk deze voordat je de parseercode schrijft. De echte veldnaam is in tien seconden gecontroleerd, en raden vanuit een artikel kan de waarschuwing stil laten falen. Kies een drempelwaarde die ten minste een dag normale uitgaven dekt, wat de CSV je vertelt: tel de kosten van gisteren op en gebruik dat als minimum.
Wanneer de waarschuwing afgaat, opwaarderen. Elk bedrag van $20 tot $500 werkt, met +5% tegoed vanaf $50, +10% vanaf $100 en +15% vanaf $200, en tegoed vervalt niet. Gebruik eerst de API key page om een sleutel voor de tracker aan te maken.
Gewoontes die uitgaven voorspelbaar houden
- Gebruik één sleutel per omgeving, zodat testverkeer nooit in productienummers verstopt raakt.
- Beperk
max_tokensop eindpunten waar lange antwoorden niet nodig zijn. Het is standaard optioneel, dus onbeperkte antwoorden zijn mogelijk. - Knip chatgeschiedenis. Input tokens zijn goedkoper dan output, maar een lange geschiedenis die bij elke beurt wordt herhaald, loopt op.
- Beoordeel het wekelijkse totaal per tag en zoek naar de tag die meer dan de helft van de rekening voor zijn rekening neemt.
Een andere gewoonte: sla de request ID op bij elke gelogde rij. Als een getal een maand later verkeerd lijkt, kun je het matchen met een specifieke aanroep in plaats van te redeneren op basis van gemiddelden. Omdat mislukte verzoeken niet worden gefactureerd, voegen retries bij fouten geen kosten toe, maar retries na een succesvol antwoord wel, dus zorg ervoor dat je retry-logica alleen bij echte fouten wordt geactiveerd. Een bug die een succesvol verzoek in een lus opnieuw verstuurt, is de meest voorkomende oorzaak van een verrassende factuur bij een pay-per-token API.
Meer handleidingen
Vragen en antwoorden
Verschijnt de saldo-header in elk antwoord?
De X-Balance-USD header maakt deel uit van de antwoordheaders voor deze API. Lees deze uit het ruwe antwoord en behandel een ontbrekende waarde als onbekend.
Kan ik kosten krijgen zonder elk verzoek te loggen?
Ja. Poll GET /v1/balance op een schema en bereken het verschil tussen de metingen.
Veranderen mislukte verzoeken het saldo?
Nee. Mislukte of geweigerde verzoeken worden niet aangerekend.
Welke endpoint moet een bestaande OpenAI-dashboardtool gebruiken?
Gebruik de OpenAI-style GET /v1/dashboard/billing/credit_grants-route, die veel tools al ondersteunen.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.