NL ▾
Base URL https://api.uncensoredaiapis.com/v1Model uncensored
API-sleutel aanvragen
Uncensored AIMigratiegids

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.

Bijgewerkt

Zwevende dashboardpanelen met een dalende grafiek en een amberkleurige waarschuwingsbel, ter illustratie van API-uitgavenmonitoring
Vijf glanzende stappensstenen die leiden naar een serverblok, illustrerend de stappen om te beginnen met een OpenAI-stijl API

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-USD antwoordheader 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_tokens op 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.

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.