DE ▾
Base URL https://api.uncensoredaiapis.com/v1Modell uncensored
API-Schlüssel erhalten
Uncensored AIMigrationsleitfaden

AI-API-Kosten-Tracker: Ausgaben mit Headern überwachen

Du kannst einen AI-API-Kosten-Tracker in etwa fünfzig Zeilen Code erstellen, da jede Antwort dir bereits deinen verbleibenden Kontostand mitteilt. Dieser Leitfaden zeigt, wie du die Ausgaben pro Anfrage protokollierst, die Balance-Endpunkte ausliest und eine Warnung ausgibst, bevor das Guthaben aufgebraucht ist.

Aktualisiert

Schwebende Dashboard-Elemente mit einem fallenden Graphen und einer bernsteinfarbenen Warn-Glocke, die die Überwachung der API-Ausgaben veranschaulicht
Fünf leuchtende Tritte, die zu einem Server-Cube führen, die Schritte zur Nutzung einer OpenAI-kompatiblen API veranschaulichend

Wichtige Punkte

  • Jede Antwort enthält einen X-Balance-USD-Header mit deinem verbleibenden Guthaben.
  • GET /v1/balance und der credit_grants-Endpunkt geben den Kontostand auf Abruf zurück.
  • Die Kosten pro Aufruf betragen (Input × 0,15 + Output × 0,50) / 1.000.000 Dollar.
  • Protokolliere in CSV und warne, wenn der Kontostand unter einen Schwellenwert fällt.

Woher die Zahlen stammen

Prepaid-Guthaben macht die Kostenverfolgung einfach, da der Anbieter bereits eine laufende Summe führt. Du erhältst sie an drei Stellen:

  • Der X-Balance-USD Antwort-Header bei API-Aufrufen, der zeigt, was nach der Anfrage noch übrig ist.
  • GET /v1/balance, eine einfache Kontostandabfrage.
  • GET /v1/dashboard/billing/credit_grants, die OpenAI-konforme Route, die Tools wie Dashboards und Wrapper bereits zu bedienen wissen.

Zusätzlich gibt jede Completion ein usage-Objekt mit Prompt- und Completion-Token-Anzahlen zurück. Kombiniere die Token-Anzahlen mit den Preisen ($0,15 pro 1M Input, $0,50 pro 1M Output) und du kannst die Kosten jeder Anfrage selbst berechnen, dann vergleiche sie mit der Saldoänderung. Beide Werte sollten übereinstimmen. Wenn dem nicht so ist, hast du etwas zur Untersuchung gefunden. Vollständige Parameterdetails findest du in den docs.

Den Header bei einer Anfrage lesen

Füge mit curl -i hinzu und schaue dir die Header an:

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 bietet das OpenAI SDK Rohantworten über with_raw_response an, das dir Header und das analysierte Objekt zusammen gibt:

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)

Ein kleiner Logger, der jeden Aufruf aufzeichnet

Verpacke deine Aufrufe in eine Funktion und schreibe jedes Mal eine CSV-Zeile. Die Zeile enthält Zeit, Request-ID, Token-Anzahlen, berechnete Kosten und Kontostand.

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

Das tag-Argument ist der Trick, der das Log nützlich macht. Gib einen Feature-Namen wie „Zusammenfassungen“ oder „Chat“ an, und später kannst du die Kosten nach Tag (tag) summieren, um zu sehen, welcher Teil des Produkts das Geld verbraucht. Die Request-ID hilft, wenn du jemals nach einer Belastung fragen oder ein Problem melden musst, da sie den genauen Aufruf identifiziert.

Die Berechnung plausibel machen

Nimm einen Aufruf mit 2.400 Input-Token und 600 Output-Token:

  • Input: 2.400 x 0,15 / 1.000.000 = 0,00036 $
  • Output: 600 x 0,50 / 1.000.000 = $0,00030
  • Gesamt: 0,00066 $

Tausend davon kosten $0,66. Wenn dein CSV einen Saldoabfall zeigt, der viel schneller ist als die Summe der berechneten Kosten, prüfe auf Retries, die du nicht geloggt hast, Hintergrundjobs, die denselben Schlüssel verwenden, oder Streams, die du offen gelassen hast. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, also sollten Fehler den Saldo überhaupt nicht verändern. Vergleiche Gesamtsummen über viele Aufrufe, nicht einzelne, damit kleine Rundungsunterschiede sich ausgleichen.

Streaming-Aufrufe und Nutzung

Mit stream: true kommen die Nutzungszahlen am Ende des Streams an. Sammle sie vom letzten Chunk und protokolliere die Zeile, nachdem der Stream geschlossen ist.

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), ""])

Wenn du nur den Kontostand brauchst, rufe GET /v1/balance nach Ende des Streams auf. Es ist eine günstige Anfrage und funktioniert auch als regelmäßige Prüfung über einen Cron-Job.

Ausgaben nach Funktion summieren

Die CSV-Datei ist nur nützlich, wenn du sie liest. Dieses kurze Skript summiert die Kosten nach Tag (tag) und zeigt den neuesten Saldo, ohne zusätzliche Pakete.

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)

Führe es täglich aus und füge die Ausgabe in deinen Team-Channel ein. Unsichtbare Ausgaben werden zu einer Zahl, über die Menschen sprechen können, und eine Funktion, die zehnmal so viel kostet wie andere, fällt sofort auf. Für einen groben Budgetplan multipliziere den täglichen Gesamtbetrag mit 30 und füge 20 Prozent Puffer hinzu.

Eine Warnung bei niedrigem Kontostand hinzufügen

Wenn das Guthaben mitten am Tag ausgeht, fällt ein Produkt aus, also warne frühzeitig. Ein Cron-Job, der alle 15 Minuten läuft, reicht aus.

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.

Drucke einmal das Roh-JSON und schaue es dir an, bevor du den Parsing-Code schreibst. Der echte Feldname lässt sich in zehn Sekunden prüfen, und das Erraten aus einem Artikel kann die Warnung still brechen. Wähle einen Schwellenwert, der mindestens einen Tag normaler Ausgaben abdeckt, was dir die CSV sagt: Summiere die Kosten von gestern und verwende das als Minimum.

Wenn die Warnung auslöst, lade auf. Jeder ganze Betrag von 20 $ bis 500 $ funktioniert, mit +5 % Guthaben ab 50 $, +10 % ab 100 $ und +15 % ab 200 $, und das Guthaben verfällt nie. Um zuerst einen Schlüssel für den Tracker zu erhalten, nutze die API-Schlüssel-Seite.

Gewohnheiten für vorhersehbare Ausgaben

  • Verwende einen Schlüssel pro Umgebung, damit Testverkehr die Produktionszahlen nicht verschleiert.
  • Begrenze max_tokens auf Endpunkten, wo lange Antworten nicht benötigt werden. Es ist standardmäßig optional, daher sind ungebundene Antworten möglich.
  • Chat-Verlauf kürzen. Input-Token sind günstiger als Output, aber ein langer Verlauf, der bei jedem Schritt wiederholt wird, summiert sich.
  • Überprüfe die wöchentliche Gesamtsumme nach Tag und achte auf das Tag, das mehr als die Hälfte der Rechnung ausmacht.

Eine weitere Gewohnheit: Speichere die Request-ID mit jeder protokollierten Zeile. Wenn eine Zahl einen Monat später falsch aussieht, kannst du sie einem spezifischen Aufruf zuordnen, anstatt aus Durchschnittswerten zu argumentieren. Da fehlgeschlagene Anfragen nicht berechnet werden, fügen Wiederholungen bei Fehlern keine Kosten hinzu, aber Wiederholungen nach einer erfolgreichen Antwort schon, also stelle sicher, dass deine Retry-Logik nur bei echten Fehlern auslöst. Ein Bug, der eine erfolgreiche Anfrage in einer Schleife erneut sendet, ist die häufigste Ursache für eine unerwartete Rechnung bei jeder Pay-per-Token-API.

Fragen und Antworten

Erscheint der Balance-Header bei jeder Antwort?

Der X-Balance-USD-Header ist Teil der für diese API aufgeführten Antwort-Header. Lies ihn aus der Rohantwort aus und behandle einen fehlenden Wert als unbekannt.

Kann ich die Kosten ermitteln, ohne jede Anfrage zu protokollieren?

Ja. Rufe GET /v1/balance regelmäßig ab und berechne die Differenz zwischen den Werten.

Ändert sich das Guthaben bei fehlgeschlagenen Anfragen?

Nein. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet.

Welchen Endpunkt sollte ein bestehendes OpenAI-Dashboard-Tool verwenden?

Nutze die OpenAI-konforme Route GET /v1/dashboard/billing/credit_grants, die viele Tools bereits unterstützen.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.