Warum die Bild-API in Coins abgerechnet wird (und sich selbst erstattet)

Beim Bau der öffentlichen API auf Fellowi Images mussten wir einige Entscheidungen treffen, die in der Dokumentation nicht als Features auftauchen - sie zeigen sich als Abwesenheit von Problemen. Das ist die Überlegung dahinter: warum es in Coins abgerechnet wird, was bei einer fehlgeschlagenen Generierung passiert, und warum ein paar Zahlen in den Docs (Rate-Limits, Aufbewahrungstage) weniger bedeuten, als sie zu bedeuten scheinen.

Coins statt Abo

Bildgenerierung hat echte, variable Kosten pro Aufruf. Ein festes Monatsabo überberechnet entweder jemanden, der fünf Bilder im Monat generiert, oder unterberechnet jemanden, der fünfhundert generiert - es gibt keine Sitzplatzzahl oder Anfragen-Quote, die sauber darauf passt. Coins lassen die Kosten direkt der Nutzung folgen: du zahlst genau das, was du tatsächlich generierst, nicht mehr. Coins verfallen nie, und es gibt nichts zu kündigen, was auch bedeutet, dass es keinen Abrechnungszyklus gibt, den man verpassen könnte - kauf ein Paket, wenn du eins brauchst, und es liegt bis dahin einfach in der Wallet.

Eine fehlgeschlagene Generierung erstattet sich selbst

Wenn eine Generierung ein Timeout erreicht oder abgelehnt wird, bevor sie ein Bild erzeugt, kommen die dafür ausgegebenen Coins automatisch und sofort zurück. Das ist kein Support-Ticket, das du eröffnen musst - es ist eine Eigenschaft des Systems: Du wirst nie für ein Bild belastet, das du nicht erhalten hast. Wir behandeln das als Zuverlässigkeitsgarantie, nicht als Gefälligkeit.

Jeder Fehlschlag löst sich in genau einen von vier Codes auf, bewusst klein gehalten:

• TIMEOUT - die Generierung hat zu lange gedauert und wurde abgebrochen.
• MODERATION_REJECTED - die Anfrage hat gegen die Inhaltsrichtlinie verstoßen.
• VENDOR_ERROR - auf der Generierungsseite ist etwas fehlgeschlagen.
• UNKNOWN - ein echter Sammelbegriff für alles, was in keinen der anderen drei passt.

Ein kleines, festes Set an Codes ist eine bewusste Entscheidung - darauf kann man tatsächlich eine switch-Anweisung schreiben, statt gegen frei formulierte Fehlerstrings zu matchen, die sich unter dir ändern könnten.

Bilder laufen nach 30 Tagen ab

Die Bytes eines generierten Bildes werden 30 Tage lang aufbewahrt. Danach existiert der Verlaufseintrag der Generierung weiterhin - dein Listen-Endpunkt zeigt weiterhin, dass es passiert ist, wann und was es gekostet hat -, aber der Abruf des tatsächlichen Bildinhalts liefert ein HTTP 410 Gone. Das ist ein klarer, nicht versteckter Kompromiss bei den Speicherkosten: Wenn du ein Bild über 30 Tage hinaus behalten willst, lade es herunter und speichere es selbst. Wir löschen den Datensatz der Generierung nie stillschweigend, nur die Bytes.

Rate-Limits sind nicht die echte Obergrenze

Das Rate-Limit pro Minute für deinen API-Schlüssel (standardmäßig 20 Anfragen pro Minute für Generierung, 120 für Lesezugriffe) existiert, um Missbrauch zu dämpfen, nicht um tatsächlich zu begrenzen, wie viele Bilder du erzeugen kannst. Dein Fellowi-Coins-Guthaben ist die echte Obergrenze - wenn du die Coins hast, kannst du sie ausgeben, bis zu dieser Rate. Wenn du ein engeres Budget willst, als dein Guthaben erlaubt, kann ein Schlüssel auch ein optionales tägliches Coin-Limit tragen, das du selbst festlegst - für deine eigene Kostenkontrolle, nicht für unsere.

Schlüssel, die du nicht zurückbekommst

Ein API-Schlüssel wird dir genau einmal angezeigt, bei der Erstellung. Danach wird auf unserer Seite nur ein Hash-Wert und eine kurze Vorschau gespeichert - dieselbe Haltung, die wir bei jedem anderen Geheimnis im Produkt einnehmen. Wenn du einen Schlüssel verlierst, erzeugst du einen neuen; es gibt keinen Wiederherstellungsprozess, weil es auf unserer Seite nichts gibt, das ihn wiederherstellen könnte.

Dieselbe Wallet, derselbe Preis

Die API und die Web-App geben aus demselben Fellowi-Coins-Guthaben aus, zum selben Preis pro Qualitätsstufe - 40 Coins für Standard, 60 für hohe Qualität. Es gibt keine separate „API-Preisgestaltung". Das ist Absicht: Deine Kosten sind vorhersehbar, egal durch welche Tür du generierst.

Die tatsächlichen Request-/Response-Formate und funktionierende Codebeispiele findest du in unserem API-Schnellstart, oder geh direkt zur API Console, um einen Schlüssel zu erstellen.