Waarom de image-API in coins wordt afgerekend (en zichzelf terugbetaalt)

Toen we de publieke image-API bovenop Fellowi Images bouwden, moesten we een handvol keuzes maken die in de documentatie niet als features opduiken - je merkt ze als de afwezigheid van problemen. Dit is de redenering erachter: waarom het in coins wordt afgerekend, wat er gebeurt als een generatie mislukt, en waarom een paar getallen in de docs (rate limits, bewaardagen) minder betekenen dan ze lijken te betekenen.

Coins, geen abonnement

Beeldgeneratie heeft echte, variabele kosten per aanroep. Een vast maandabonnement rekent iemand die vijf beelden per maand maakt te veel, of iemand die er vijfhonderd maakt te weinig - er is geen aantal gebruikers of verzoekenquotum dat daar netjes op past. Met coins volgen de kosten je gebruik rechtstreeks: je betaalt precies wat je daadwerkelijk genereert, niets meer. Coins verlopen nooit en er is niets op te zeggen, wat ook betekent dat er geen factuurcyclus is die je kunt missen - koop een pakket wanneer je er een nodig hebt, en tot die tijd blijft het gewoon in je wallet staan.

Een mislukte generatie betaalt zichzelf terug

Loopt een generatie in een timeout of wordt hij afgewezen voordat er een beeld uit komt, dan komen de coins die je eraan besteedde automatisch en direct terug. Dit is geen supportticket dat je moet aanmaken - het is een eigenschap van het systeem: je wordt nooit belast voor een beeld dat je niet hebt gekregen. Wij zien dat als een betrouwbaarheidsgarantie, niet als een gunst.

Elke mislukking komt uit op precies een van vier codes, bewust kort gehouden:

• TIMEOUT - de generatie duurde te lang en is afgebroken.
• MODERATION_REJECTED - het verzoek ging in tegen het contentbeleid.
• VENDOR_ERROR - er ging iets mis stroomopwaarts, aan de generatiekant.
• UNKNOWN - een echte restcategorie voor alles wat niet in de andere drie past.

Een kleine, vaste set codes is een bewuste keuze - hier kun je daadwerkelijk een switch-statement tegenaan schrijven, in plaats van patronen te matchen op vrije foutteksten die onder je vandaan kunnen veranderen.

Beelden verlopen na 30 dagen

De bytes van een gegenereerd beeld bewaren we 30 dagen. Daarna bestaat het geschiedenisrecord van de generatie nog steeds - je list-endpoint laat nog zien dat het gebeurd is, wanneer en wat het kostte - maar het opvragen van de eigenlijke beeldinhoud geeft een HTTP 410 Gone. Dat is een gewone, niet-verborgen afweging in opslagkosten: wil je een beeld langer dan 30 dagen houden, download het en bewaar het zelf. We verwijderen het record van de generatie nooit stilletjes, alleen de bytes.

Rate limits zijn niet het echte plafond

De rate limit per minuut op je API-sleutel (standaard 20 verzoeken per minuut voor generatie, 120 voor leesacties) bestaat om misbruik te dempen, niet om te bepalen hoeveel beelden je kunt maken. Je Fellowi Coins-saldo is het echte plafond - heb je de coins, dan kun je ze uitgeven, tot aan die snelheid. Wil je een strakker budget dan je saldo toelaat, dan kan een sleutel ook een optionele dagelijkse coinlimiet dragen die je zelf instelt, voor jouw kostenbeheersing en niet de onze.

Sleutels die je niet terugkrijgt

Een API-sleutel krijg je precies eenmaal te zien, bij het aanmaken. Daarna bewaren wij alleen een gehashte waarde en een korte preview - dezelfde houding die we bij elk ander geheim in het product aannemen. Verlies je een sleutel, dan maak je een nieuwe aan; er is geen herstelproces, omdat er aan onze kant niets is dat hem kan herstellen.

Dezelfde wallet, dezelfde prijs

De API en de webappgeven uit hetzelfde Fellowi Coins-saldo uit, tegen exact dezelfde prijs per kwaliteitsniveau - 40 coins voor Standard, 60 voor hoge kwaliteit. Er bestaat geen aparte “API-prijs”. Dat is opzet: je kosten zijn voorspelbaar, via welke deur je ook genereert.

Voor de echte request- en responsvormen en werkende codevoorbeelden, zie onze API-quickstart, of ga direct naar de API Console om een sleutel aan te maken.