Konzepte

Guthaben & Abrechnung

Wie das Gateway Nutzung je Endpunkt misst, vom Guthaben abbucht und wann es eine Anfrage mangels Guthaben ablehnt.

Die Nutzung der von Noirdoc verwalteten Modelle bezahlt Ihre Organisation aus einem Guthaben. Das Guthaben laden Admins im Voraus auf. Das Gateway bucht die Kosten jeder erfolgreichen Anfrage davon ab.

Einige Organisationen werden stattdessen per Rechnung abgerechnet. Für sie gilt der Abschnitt zum Guthaben nicht; die Nutzung wird nachträglich in Rechnung gestellt. Welche Abrechnungsart gilt, zeigt das Portal unter Abrechnung.

Abgerechnete Anfragen

Das Gateway rechnet eine Anfrage ab, wenn alle drei Bedingungen gelten:

  • Ein von Noirdoc verwalteter Anbieter hat sie beantwortet. Anfragen über eigene Anbieter (BYOK) bezahlen Sie direkt bei Ihrem Anbieter; das Gateway rechnet sie nicht ab.
  • Die Antwort hat einen Statuscode unter 400. Abgelehnte und fehlgeschlagene Anfragen kosten nichts.
  • Die Anfrage nennt ein Modell aus dem Katalog.

Die Einheit hängt vom Endpunkt ab:

EndpunktAbrechnung nach
/v1/chat/completions, /v1/responses, /v1/messagesTokens: Eingabe und Ausgabe, Cache-Tokens mit eigenem Preis, sofern das Modell einen hat
/v1/embeddingsEingabe-Tokens
/v1/audio/speechZeichen des Eingabetexts
/v1/audio/transcriptionsDauer des Audios, die der Anbieter meldet; der Preis gilt je Minute und wird anteilig berechnet
/v1/images/generationsje Bild oder je Megapixel, je nach Modell

Die Preise je Modell und Anbieter liefert der öffentliche Endpunkt GET /v1/prices. Siehe Modelle & Preise.

Aufladung

Admins Ihrer Organisation laden Guthaben unter Abrechnung → Aufladen auf. Die Zahlung läuft über den Zahlungsdienstleister Mollie, per Karte oder SEPA-Überweisung. Sie wählen einen Betrag in ganzen Euro; das Formular nennt Mindest- und Höchstbetrag. Gutgeschrieben wird der gewählte Betrag. Fällt Umsatzsteuer an, zahlen Sie sie zusätzlich; das Portal zeigt beide Beträge vor der Zahlung.

Das Guthaben steht bereit, sobald Mollie die Zahlung bestätigt. Bei einer Überweisung dauert das in der Regel 1–2 Bankarbeitstage nach Zahlungseingang.

Legen Sie im Portal Ihre erste Organisation an, erhält sie ein Startguthaben. Es gilt einmal je Konto: Weitere Organisationen, die Sie anlegen, erhalten kein Startguthaben. Eine Einladung in eine andere Organisation verbraucht es nicht.

Abbuchung

Das Gateway bucht die Kosten nach der Antwort ab, auf Grundlage der tatsächlichen Nutzung und der Preise zum Zeitpunkt der Anfrage. Weil die Abbuchung erst nach der Antwort feststeht, kann der Kontostand unter null fallen. Die nächste Aufladung gleicht den offenen Betrag aus; das Portal zeigt ihn vor der Zahlung an.

Kontostand, Buchungen und Belege sehen alle Mitglieder unter Abrechnung.

Anfragen ohne ausreichendes Guthaben

Vor dem Weiterleiten prüft das Gateway, ob das Guthaben für die Anfrage reicht. Die Prüfung gilt nur für Anfragen an verwaltete Anbieter; eigene Anbieter prüft das Gateway nicht.

Für Anfragen an Chat- und Embedding-Modelle schätzt das Gateway die höchstmöglichen Kosten:

  • Eingabe: die Länge der Eingabefelder, umgerechnet mit vier Zeichen je Token.
  • Ausgabe (nur Chat): der Wert aus max_tokens, max_completion_tokens oder max_output_tokens. Fehlt er, rechnet das Gateway mit 4.096 Tokens.

Bei Bildern schätzt es die Kosten aus Anzahl und Größe der Bilder. Bei Audio prüft es nur, ob noch Guthaben vorhanden ist. Ist das Guthaben aufgebraucht oder kleiner als die Schätzung, lehnt das Gateway die Anfrage mit Statuscode 402 ab, bevor sie einen Anbieter erreicht. Die Ablehnung kostet nichts.

JSON
{
  "error": {
    "type": "proxy_error",
    "code": "insufficient_credit",
    "message": "This request could cost up to 1.84 EUR, more …"
  }
}

Nennt die Meldung eine Schätzung, reicht oft ein kleineres max_tokens oder eine kürzere Eingabe. Ohne Schätzung ist das Guthaben aufgebraucht; dann hilft nur eine Aufladung.

StatusCodeBedeutung
402insufficient_creditDas Guthaben der Organisation ist aufgebraucht oder kleiner als die geschätzten Höchstkosten der Anfrage.
402key_budget_exhaustedDas Budget dieses Schlüssels ist für den laufenden Zeitraum aufgebraucht oder reicht für die geschätzten Kosten der Anfrage nicht aus.
403model_not_billableFür das Modell ist kein vollständiger Preis hinterlegt, deshalb lässt es sich mit Guthaben nicht nutzen.