Häufige Fragen

Abrechnung und Guthaben

Wie Service-Guthaben abgebucht werden, wann Sie aufladen müssen und was eine 402-Antwort bedeutet.

Die API-Nutzung auf der Felo API Platform wird im Voraus bezahlt. Sie kaufen auf USD lautende Service-Guthaben, und jede Anfrage wird mit dem geltenden Tarif von diesem Guthaben abgezogen.

So funktioniert die Abrechnung

Eine Aufladung kauft Service-Guthaben, kein von der Plattform gehaltenes Barguthaben.
Das Guthaben lautet auf USD, damit Berechnungen in Dollar ausgedrückt werden können.
Aufladungen beginnen bei $1. Ein Abonnement ist nicht erforderlich.
Das Guthaben wird ausschließlich zur Verrechnung von API-Berechnungen der Plattform verwendet. Es kann nicht ausgezahlt oder gegen Bargeld eingetauscht werden.
Abgeschlossene Aufladungen sind nicht erstattungsfähig, einschließlich nicht genutzter Guthaben, sofern zwingendes anwendbares Recht nichts anderes vorschreibt.

Dasselbe Guthaben bezahlt Modellaufrufe, Data API-Aufrufe und Felo API-Aufrufe. Sie benötigen kein separates Konto und kein separates Guthaben für jeden Anbieter.

Was eine Anfrage kostet

Die Berechnung hängt vom Endpoint ab:

Oberfläche	Abrechnungsgrundlage
Model API	Token-Tarife für Eingabe, Ausgabe und Caching sowie eventuell berechnete Tools; der Rabattmultiplikator des Kanals gilt
Data API	Die für diesen Endpoint veröffentlichte Abrechnungsgrundlage, die pro erfolgreicher Anfrage, pro zurückgegebenem Element oder nach tatsächlicher Nutzung erfolgen kann
Felo APIs (`/v2`)	Der Tarif für die Ausgabe dieses Workflows

Modellpreise werden auf der Preisseite und auf jeder Modellseite pro 1 Mio. Token angezeigt. Die Formel und ein durchgerechnetes Beispiel finden Sie unter Modelle und Preise.

Guthaben prüfen und aufladen

Öffnen Sie Console Billing. Die Console zeigt Ihren aktuellen Guthabenstand, Aufladungsbeträge und Nutzungsdatensätze. Verfügbare Zahlungsmethoden hängen von Ihrer Region ab und werden beim Checkout angezeigt.

Die 402-Antwort

Eine 402-Antwort bedeutet, dass das Guthaben den Aufruf nicht abdeckt:

{
  "status": 402,
  "code": "INSUFFICIENT_CREDITS",
  "message": "...",
  "request_id": "..."
}

Was Sie tun sollten:

Prüfen Sie das Guthaben in Console Billing.
Laden Sie auf.
Senden Sie die Anfrage erneut. Eine 402-Antwort ist kein Rate-Limit; Warten allein behebt sie nicht.

Bei einer asynchronen Aufgabe bedeutet eine 402-Antwort beim Senden, dass die Aufgabe nie erstellt wurde. Prüfen Sie den Status-Endpoint der Aufgabe, bevor Sie erneut senden.

Abrechnung im Vergleich zu Rate-Limits

Dies sind unterschiedliche Limits:

Guthaben begrenzt, wie viel Sie ausgeben können. Wenn es aufgebraucht ist, wird 402 zurückgegeben.
Rate-Limits begrenzen, wie schnell Sie aufrufen können. Wenn eines überschritten wird, wird 429 zurückgegeben.

Die 429-Header und Wiederholungsregeln finden Sie unter Fehler, Limits und Wiederholungen.

Abonnements und Guthaben

Die API-Nutzung wird immer aus Service-Guthaben bezahlt. Das einzige in dieser Dokumentation beschriebene Abonnementverhalten ist die Ausnahme von den Rate-Limits für /v2/chat für Konten mit einem wirksamen bezahlten Felo-Abonnement; es ersetzt keine Service-Guthaben.

Fragen zur Abrechnung

Bei einer beanstandeten Berechnung oder einer nicht eingegangenen Aufladung kontaktieren Sie den Support mit:

Der E-Mail-Adresse des Kontos
Dem ungefähren Zeitpunkt der Berechnung
Der request_id aus einem zugehörigen Fehler
Dem Aufladungsbetrag und der Zahlungsreferenz

Senden Sie niemals Ihren vollständigen API-Schlüssel.