GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Alle Anleitungen

· reAPI Team

fal.ai: Abrechnung fehlgeschlagener Anfragen – was kostet

Verstehe die Abrechnung fehlgeschlagener fal.ai-Anfragen: Serverfehler, ungültige Eingaben und Timeouts. Gleiche vor Wiederholungen oder Erstattungsanfragen die Aufgaben-IDs ab.

fal.ai: Abrechnung fehlgeschlagener Anfragen – was kostet

Eine Belastung neben einem fehlgeschlagenen Bild fühlt sich an, als würdest du für nichts bezahlen. Die veröffentlichte Richtlinie von fal unterscheidet genauer: Serverfehler ab HTTP 500 werden nicht berechnet, ein Fehler wegen ungültiger Eingaben mit HTTP 422 kann aber berechnet werden, wenn ein Runner GPU-Zeit verbraucht hat, bevor er das Problem erkannt hat.[1]

Das ist der Ausgangspunkt für die Rechnungsprüfung. „Fehlgeschlagen“ in deiner App ist noch keine Abrechnungskategorie. Du brauchst die Antwort der konkreten Anfrage und musst wissen, ob der Fehler während der Generierung oder beim Versuch deiner App auftrat, das Ergebnis abzurufen.

Der Unterschied zwischen 500 und 422

Für fal Model APIs erklärt die offizielle FAQ, dass dich Infrastrukturfehler nichts kosten. Als Kategorie für Serverfehler nennt sie HTTP 500 und höher. Zeigt dein Anfrageprotokoll dieses Ergebnis und eine entsprechende endgültig abgerechnete Belastung, hast du eine konkrete Abweichung von der Richtlinie, zu der du den Support befragen kannst.[1]

Prüfe vor diesem Vergleich, woher die Antwort stammt. Ein 500 deiner eigenen Anwendung beim Anzeigen eines Bildes ist nicht derselbe Datensatz wie ein 500 der Modellanfrage. Bewahre die fehlerhafte URL oder Operation zusammen mit dem Fehler auf. Sonst können dieselben drei Ziffern dazu führen, dass du die Generierungsrichtlinie auf einen späteren Schritt anwendest.

Ein 422 erfordert einen genaueren Blick. Laut fal können ungültige Eingaben erst erkannt werden, nachdem der Runner bereits GPU-Zeit verbraucht hat; diese Arbeit kann kostenpflichtig sein.[1] Die Richtlinie besagt nicht, dass jeder 422 berechnet wird. Auch die Formulierung „ungültige Eingabe“ belegt nicht, dass der Dienst die Anfrage abgelehnt hat, bevor er irgendeine Arbeit ausgeführt hat.

Lies die Meldung zusammen mit den Eingabeanforderungen des gewählten Modells. Hat ein Pflichtfeld oder eine Dateieigenschaft den Fehler verursacht, korrigiere diese Bedingung, bevor du eine Ersatzanfrage sendest. Ändere nicht mehrere unabhängige Einstellungen gleichzeitig: Sonst wird es schwieriger festzustellen, welche Änderung den dokumentierten Fehler behoben hat.

Auch Fehler aufgrund der Inhaltsrichtlinie müssen anhand ihrer tatsächlichen Klassifizierung beurteilt werden. Die FAQ von fal bezeichnet content_policy_violation als nicht wiederholbaren 422-Fehler.[1] Dieselbe abgelehnte Eingabe wiederholt zu senden, ist keine sinnvolle Strategie zur Wiederherstellung der Infrastruktur. Bewahre für die Abrechnung den Fehler und den endgültig abgerechneten Verbrauch der Anfrage auf; der Fehlername allein sagt dir nicht, wie viel letztlich berechnet wurde.

Kostenlose Credits können einen Test finanzieren, ohne diese grundlegende Unterscheidung zu ändern. fal dokumentiert Guthabenzuteilungen und Gutscheine mit jeweils eigenen Gültigkeitsbedingungen.[1] Prüfe, was dein Konto tatsächlich enthält. Gehe nicht davon aus, dass jeder Nutzer kostenlose Nutzung erhält oder ein Ersatzversuch kostenlos ist. Plane kostenpflichtige Modellnutzung ein, sobald die geltende Zuteilung sie nicht mehr abdeckt.

Der fal.ai-Preisleitfaden behandelt das umfassendere Kostenmodell. Hier ist der beworbene Einstiegspreis eines Modells weniger hilfreich als das Protokoll des Versuchs, dessen Abrechnung du beanstandest.

Ein Fehler auf dem Bildschirm kann zu einem anderen Schritt gehören

Betrachte einen hypothetischen Bildauftrag. Deine Anwendung sendet ihn, wartet und läuft dann in ein Timeout. Du drückst erneut auf Generieren. Später siehst du ein niedrigeres Guthaben und ein Bild in der Oberfläche.

Nun sind zwei Übermittlungen zu untersuchen. Der Bildschirm belegt nicht, ob die erste beim Anbieter fehlgeschlagen ist, ob beide abgeschlossen wurden oder welches Bild du siehst. Suche vor einer Erstattungsanfrage die ursprünglichen Anfrage-IDs und prüfe ihre Ergebnisse getrennt. Ist eine abgeschlossen, versuche dieses Ergebnis abzurufen, statt die fehlende Vorschau als Beweis dafür zu betrachten, dass die Generierung nie stattgefunden hat.

Diese Unterscheidung steht ausdrücklich in WaveSpeeds Erstattungshinweisen für Sync Mode. Bei einem Timeout im Client, Proxy, Browser, Gateway oder Netzwerk kann die Vorhersage auf dem Server weiterlaufen. Wird sie erfolgreich abgeschlossen, berechtigt dieses Client-Timeout nicht automatisch zur Erstattung; die Hinweise fordern Nutzer auf, die Vorhersage anhand ihrer ID abzurufen.[2] Das ist die dokumentierte Richtlinie von WaveSpeed, keine Ausweitung von fals 500-Regel auf einen anderen Dienst.

Bei fals Warteschlangenablauf erfordert COMPLETED ohne angezeigtes Ergebnis eine eigene Prüfung des Ergebnisabrufs. Halte Übermittlungsantwort, Statusantwort und Ergebnisantwort in deinen Logs getrennt. Schlägt ein späterer Download fehl, bewahre die erhaltene URL auf und untersuche diesen Dateizugriff gesondert.

Wenn schon die Übermittlungsantwort verloren ging, hast du weniger Informationen. Kennzeichne den ursprünglichen Auftrag nicht allein deshalb als erstattet, weil dein Code nie eine ID gespeichert hat. Prüfe den Kontoverlauf und verfügbare Anfrageprotokolle oder bitte den Support, das Ereignis anhand von Modell und Zeitstempel zu finden. Beschreibe das Ergebnis bis dahin als ungeklärt. Ein neuer POST kann einen weiteren Versuch erzeugen, ohne den ersten zu klären.

Abgebrochen bedeutet nicht unbedingt kostenlos

Beim Abbruch kommt es auf den Zeitpunkt an. Replicate dokumentiert, dass eine Vorhersage, die vor Verarbeitungsbeginn ihre Frist erreicht, abgebrochen und nicht berechnet wird. Läuft die Frist erst nach Verarbeitungsbeginn ab, wird die Vorhersage abgebrochen und die Verarbeitungszeit ist kostenpflichtig.[3]

In einer App mit nur einer Stopp-Schaltfläche geht dieser Unterschied leicht verloren. Der Nutzer kann das Zuschauen beenden, die Anwendung den Abbruch anfordern und der Anbieter einen Endzustand bestätigen – jeweils zu unterschiedlichen Zeitpunkten. Protokolliere das bestätigte Ergebnis. Einen Tab zu schließen, beweist nicht, dass der Anbieter eine Abbruchanfrage erhalten oder ausgeführt hat.

Replicates Abrechnungsregeln unterscheiden außerdem zeitbasierte Vorhersagen von offiziellen Modellen und bereitgestellter Infrastruktur. Bei einem abgebrochenen zeitbasierten Lauf wird die bereits verbrauchte Verarbeitungszeit berechnet; der Abbruch eines offiziellen Modells kann weiterhin kostenpflichtig sein. Die meisten privaten Modelle und Deployments haben eigene Regeln zur Instanzzeit.[4] Eine Abbruchrichtlinie für eines davon beschreibt nicht automatisch die anderen.

Wenn du Anbieter vergleichst, halte diese Diensttypen erkennbar auseinander. Eine Anfrage an ein öffentliches Modell und ein dediziertes Deployment können nach unterschiedlichen Maßstäben Kosten verursachen, auch wenn beide Bilder erzeugen. Der Leitfaden zu Kosten ungenutzter Deployments erklärt, warum ein leerer Anfrageverlauf keine Infrastrukturrechnung klärt.

Für die beanstandete Anfrage bleiben die hilfreichen Fragen konkret: Hat die Verarbeitung begonnen, welcher Endzustand wurde protokolliert und was berechnet die Abrechnungsvereinbarung dieses Modells dafür? Die Menge der dem Nutzer angezeigten Medien kann diese Fragen allein nicht beantworten.

Anfrage und Geld gehören in dieselbe Zeile

Du brauchst kein großes Berichtssystem, um eine einzelne Belastung zu untersuchen. Beginne mit der Anfrage-ID des Anbieters, dem Modell, der Übermittlungszeit und der Zeitzone. Ergänze die Komponente, die den Fehler gemeldet hat, den genauen Fehler und das neueste Ergebnis beim Anbieter. Füge dann den beanstandeten Betrag und etwaige spätere Rückbuchungen hinzu.

Wenn du es erneut versucht hast, gib jedem Ersatzversuch eine eigene Zeile. Verknüpfe ihn mit dem ursprünglichen Auftrag, aber fasse die Versuche nicht zu einem einzigen Eintrag „fehlgeschlagene Anfrage“ zusammen. Im hypothetischen Timeout-Beispiel lässt sich nur durch diese Trennung feststellen, ob die Guthabenänderung zur ersten Übermittlung, zum Ersatz oder zu beiden gehört.

Unterscheide auch eine Reservierung vom endgültig abgerechneten Verbrauch, wenn die Plattform beides ausweist. reAPI reserviert Credits bei der Übermittlung und meldet die Abrechnung über den Aufgabenlebenszyklus. Ein endgültig abgerechneter Verbrauch von null bei einer laufenden Aufgabe bedeutet nicht, dass die Reservierung zurückgegeben wurde. Eine fehlgeschlagene Aufgabe mit null endgültig abgerechneten Credits ist ein erstattetes Ergebnis; bei manchen modellspezifischen Sicherheitsfehlern nach der Generierung kann eine positive Belastung bestehen bleiben.[5]

Diese Unterscheidungen gehören zur Untersuchung, auch wenn das Dashboard nur eine Guthabenzahl verwendet. Ein nicht verfügbarer Betrag ist nicht null. Ein früherer Abzug ist nicht unbedingt der endgültige Betrag. Bewahre auf, was der Anbieter tatsächlich ausweist, statt ein fehlendes Feld mit dem erwarteten Ergebnis zu füllen.

Eine Supportnachricht kann dann kurz sein: Identifiziere die Anfrage, nenne ihren protokollierten endgültigen Fehler und den endgültig abgerechneten Betrag sowie die Richtlinie, die dazu im Widerspruch zu stehen scheint. Bitte den Support zu bestätigen, welche Abrechnungskategorie auf diese Anfrage zutrifft. Nenne die zugehörigen Ersatz-IDs, damit wiederholte Arbeit von einer doppelten Belastung unterschieden werden kann.

Entferne vor der Weitergabe API-Schlüssel, Kartendaten und nicht relevante private Eingaben. Der Support braucht genug Kontext, um das Ereignis zu finden und zu verstehen, keine öffentliche Kopie jeder Datei des Auftrags. Ordne spätere Korrekturen derselben Anfrage zu, damit der Fall anhand von Belegen abgeschlossen werden kann.

Auch eine korrekte Rechnung kann zu einem teuren Workflow gehören

Der Abgleich der Belastung beantwortet, ob die Richtlinie angewendet wurde. Er beantwortet nicht, ob der Workflow sein Geld wert ist. Ein erfolgreiches, aber unbrauchbares Ergebnis gehört weiterhin zu den Kosten der Projektabwicklung, auch wenn der Generierungsdienst seinen Vertrag erfüllt hat.

Für diese zweite Frage teilst du die gesamten endgültig abgerechneten Generierungskosten eines Arbeitspakets durch die Zahl der zur Verwendung akzeptierten Ergebnisse. Das ist eine vorgeschlagene Betriebskennzahl, keine Abrechnungsformel eines Anbieters. Definiere vor der Bewertung, was akzeptiert bedeutet: etwa die erforderlichen Abmessungen, die Konsistenz des Motivs und die Eignung für den vorgesehenen Zweck.

Halte ungeprüfte Ergebnisse von abgelehnten getrennt. Wenn noch kein Ergebnis akzeptiert wurde, gib keine endlichen Kosten pro akzeptiertem Ergebnis an. Du hast Geld ausgegeben, ohne dieses Ziel bisher zu erreichen. Die Protokolle auf Anfrageebene bleiben wichtig, weil sie zeigen, welcher Anteil der Ausgaben auf kostenpflichtige Fehler, bewusste Neuversuche oder unnötige Ersatzübermittlungen entfällt.

Diese Aufschlüsselung zeigt dir, wo eine Änderung helfen könnte. Bei einem Eingabeproblem musst du die dokumentierten Anforderungen prüfen. Geht ein abgeschlossener Auftrag in deiner App verloren, musst du den Abruf verbessern. Trifft ein Abbruch erst nach Verarbeitungsbeginn ein, solltest du prüfen, wann die Anwendung den Stopp anfordert. Für die Eignung der Ergebnisse kann es sich lohnen, einen Modellwechsel zu prüfen. Er ersetzt aber nicht die Klärung, welches dieser Probleme du hast.

Nimm einen kleinen hypothetischen Stapel: vier Versuche zu jeweils einer Kosteneinheit, alle vier Beträge nachweislich endgültig abgerechnet. Zwei Ergebnisse werden akzeptiert, ein abgeschlossenes Ergebnis verfehlt die Vorgaben und ein fehlgeschlagener Versuch ist nach der geltenden Richtlinie kostenpflichtig. Die Ausgaben betragen vier Einheiten für zwei akzeptierte Ergebnisse, also zwei Einheiten pro akzeptiertem Ergebnis. Weder der Einheitspreis noch diese Ergebnisse sind Messwerte eines Anbieters.

Angenommen, eine Untersuchung ergibt nun, dass der fehlgeschlagene Versuch nicht hätte berechnet werden dürfen, und eine Einheit wird tatsächlich zurückgegeben. Die korrigierten Kosten betragen drei Einheiten geteilt durch zwei akzeptierte Ergebnisse, also jeweils eineinhalb Einheiten. Das unbrauchbare, aber erfolgreich generierte Bild gehört weiterhin zu den Projektkosten. Eine Erstattung hat eine Belastung korrigiert, aber das andere Bild nicht in ein lieferfähiges Ergebnis verwandelt.

Quellen

  1. fal.ai. Model APIs FAQ: fehlgeschlagene Anfragen, Guthabenzuteilungen und Abrechnung. Abgerufen am 15. November 2026.
  2. WaveSpeedAI. Erstattungsrichtlinie: Timeouts im Sync Mode. Abgerufen am 15. November 2026.
  3. Replicate. Vorhersagelebenszyklus: Abbruch und Fristen. Abgerufen am 15. November 2026.
  4. Replicate. Abrechnung: öffentliche Modelle, private Modelle, Deployments und abgebrochene Vorhersagen. Abgerufen am 15. November 2026.
  5. reAPI. Aufgaben: Status, Reservierungen und endgültige Abrechnung. Gelesen am 15. November 2026.
Alle Anleitungen