JSM DocsMarkdown aus /home/ag/codex

openai-billing-info/README.md

openai-billing-info/README

JSM Portal

OpenAI Billing Info

Kleines Node-CLI, das die offiziell erreichbaren OpenAI-Organisationsdaten abruft:

  • Kosten (organization/costs)
  • Usage fuer Completions
  • Usage fuer Embeddings
  • Usage fuer Images
  • Usage fuer Moderations
  • Usage fuer Vector Stores
  • Usage fuer Code Interpreter Sessions
  • Usage fuer Audio Speeches
  • Usage fuer Audio Transcriptions

Daraus zeigt es optional auch ein Restbudget oder ein geschaetztes Restguthaben.

Wichtig:

  • Fuer den API-Zugriff wird ein OPENAI_ADMIN_KEY benoetigt.
  • Das CLI nutzt nur normal erreichbare Organisations-Endpunkte unter /v1/organization/....
  • Ein offizieller API-Endpoint fuer das direkte Prepaid-Guthaben / den Kontostand ist derzeit nicht dokumentiert.
  • Wenn du das echte Guthaben aus dem Billing-Dashboard kennst, kannst du es ueber OPENAI_PREPAID_BALANCE hinterlegen und dir ein geschaetztes Restguthaben ausgeben lassen.

Setup

  1. .env.example nach .env kopieren
  2. OPENAI_ADMIN_KEY eintragen
  3. Optional OPENAI_MONTHLY_BUDGET oder OPENAI_PREPAID_BALANCE setzen
  4. Starten:
npm start

Beispiele:

npm start -- --days 7
npm run today
npm start -- --json

Ausgabe

Das CLI zeigt:

  • Gesamtkosten im gewaehlten Zeitraum
  • Tageswerte fuer Kosten
  • aggregierte Usage-Werte je Endpunkt
  • optional verbleibendes Monatsbudget
  • optional geschaetztes Restguthaben

npm run today zeigt nur die heutigen Werte seit 00:00 Uhr des Server-Tages.

Relevante OpenAI-Seiten

  • API-Referenz Costs: https://platform.openai.com/docs/api-reference/usage/costs
  • Usage Dashboard / Billing: https://platform.openai.com/settings/organization/billing
  • Credit Grants im Billing-Bereich: https://platform.openai.com/settings/organization/billing/credit-grants

Einschränkung

Wenn du wirklich den exakten aktuellen Credit-Stand brauchst, ist der verlaesslichste offizielle Weg derzeit das Billing-Dashboard von OpenAI. Dieses Projekt nutzt absichtlich nur normal erreichbare API-Funktionen und vermeidet browsergebundene Billing-Endpunkte.