aisplice

API-Referenz

Abrechnung & Guthaben

Wallet-finanziert, Abrechnung pro Aufruf. Token-basierte Modelle werden pro 1 Mio. Eingabe- und Ausgabe-Tokens abgerechnet; Bild-, Video- und Task-Modelle pro Anfrage. Fehlgeschlagene Anfragen werden automatisch erstattet.

#Preis pro Token

Eingabe- und Ausgabe-Tokens werden getrennt gemessen. Den vollständigen Preis pro Modell zeigt die Karte unter /models; jede abgeschlossene Anfrage zeigt ihren endgültigen tatsächlichen Verbrauch im Anfrageprotokoll.

usage.json
{
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 402,
    "total_tokens": 530
  }
}

Das Kontingent wird zu Beginn der Anfrage vorab reserviert (Schätzung für den ungünstigsten Fall anhand von max_tokens) und nach Abschluss der Antwort mit der vom Anbieter gemeldeten Nutzung abgeglichen — Sie zahlen immer nur die tatsächliche Nutzung.

#Preis pro Anfrage

Bild-, Video-, TTS- und andere Task-Modelle berechnen einen Festpreis pro erfolgreichem Aufruf. Unterschiedliche Auflösungen oder Längen können unterschiedliche Preise haben — prüfen Sie immer zuerst die Modellkarte.

#Preisstufen

Modelle mit Preis pro Anfrage können mehrere Stufen haben: Bildstufen richten sich nach Größe und Qualität, Videostufen nach Dauer und Auflösung. Die Stufe wird beim Einreichen aus Ihren Anfrageparametern ermittelt, und der Preis jeder Stufe steht auf der Modellkarte.

Preisstufen

size, quality und duration bestimmen die abgerechnete Stufe — die Modellkarte nennt den genauen Preis pro Stufe, und fehlgeschlagene Aufrufe werden automatisch erstattet.

#Erstattungen

Vorab belastetes Kontingent wird automatisch zurückgegeben, wenn eine Anfrage fehlschlägt oder ein asynchroner Task nie abgeschlossen wird. Das Anfrageprotokoll zeigt den endgültigen tatsächlichen Verbrauch, sodass fehlgeschlagene Aufrufe nicht als separate Belastung und Erstattung erscheinen.

#Guthaben & Aufladung

#Das Wallet

Die gesamte Nutzung wird über ein einziges Prepaid-Wallet abgerechnet — es gibt keine nachträgliche Rechnungsstellung. Alle Schlüssel nutzen dasselbe Guthaben, sofern ein Schlüssel kein eigenes Kontingentlimit hat.

#Aufladen

Laden Sie unter Konsole → Wallet auf. Verfügbare Zahlungswege (Karte / andere Anbieter) und der Mindestbetrag für die Aufladung werden beim Bezahlen angezeigt; dort lassen sich auch Einlösecodes anwenden, die sofort gutgeschrieben werden.

Guthaben verfällt nicht. Ist eine Zahlung erfolgreich, das Guthaben aber nach einigen Minuten unverändert, eröffnen Sie ein Support-Ticket mit der Zahlungsreferenz.

Wallet öffnen

#Wenn das Guthaben knapp wird

Kann das Guthaben die vorab reservierte Schätzung einer Anfrage nicht decken, schlägt der Aufruf sofort mit 402 insufficient_quota fehl — es wird nichts berechnet. Laden Sie auf und versuchen Sie es erneut; bereits laufende lange Streams werden nie mitten in der Antwort abgebrochen.

#Nutzung & Protokolle

#Nutzungs-Dashboard

Konsole → Nutzung zeigt Tokens und Ausgaben pro Modell und Tag als Diagramm, aufgeschlüsselt nach Schlüssel — der schnellste Weg, um zu sehen, welches Projekt oder Modell die Kosten treibt.

Nutzung öffnen

#Tatsächlicher Verbrauch

Konsole → Anfrageprotokoll ist für Kunden die maßgebliche Quelle für API-Ausgaben. Jede Zeile enthält Zeitstempel, Modell, Token-Nutzung oder Aufrufpreis, Anfrage-ID und den endgültig verbrauchten Betrag.

Nutzung öffnen

#Anfrage-IDs

Jede Zeile im Anfrageprotokoll enthält die Anfragekennung und den Zeitstempel. Wenn Sie ein Support-Ticket zu einem bestimmten Aufruf eröffnen, nennen Sie diese Zeile (Zeit, Modell, Anfrage-ID) — so kann der Support den genauen Upstream-Versuch nachverfolgen.

Prompts werden nicht gespeichert

Das Gateway speichert Metadaten (Modell, Tokens, Kosten, Zeitstempel, Anfrage-ID) — keine Prompt-Inhalte —, es sei denn, Sie aktivieren ausdrücklich das Anfrage-Logging zur Fehlersuche.

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.