Varför bild-API:et prissätts i coins (och återbetalar sig självt)

När vi byggde det publika bild-API:et ovanpå Fellowi Images måste vi fatta en handfull beslut som inte syns i dokumentationen som funktioner - de syns som frånvaron av problem. Det här är resonemanget bakom dem: varför det prissätts i coins, vad som händer när en generering misslyckas, och varför ett par tal i dokumentationen (rate limits, lagringsdagar) betyder mindre än de ser ut att göra.

Coins, inte abonnement

Bildgenerering har en verklig, variabel kostnad per anrop. Ett fast månadsabonnement överdebiterar antingen den som genererar fem bilder i månaden, eller underdebiterar den som genererar femhundra - det finns inget antal platser eller anropskvot som mappar rent mot det. Coins låter kostnaden följa användningen direkt: du betalar precis det du faktiskt genererar, inget mer. Coins går aldrig ut och det finns inget att säga upp, vilket också betyder att det inte finns någon faktureringscykel att missa - köp ett paket när du behöver ett, och det ligger kvar i wallet till dess.

En misslyckad generering återbetalar sig själv

Om en generering får timeout eller avvisas innan den producerar en bild kommer de coins du lade på den tillbaka automatiskt och omedelbart. Det här är inget supportärende du måste skicka in - det är en egenskap hos systemet: du debiteras aldrig för en bild du inte fick. Vi behandlar det som en tillförlitlighetsgaranti, inte som en artighet.

Varje misslyckande landar i exakt en av fyra koder, medvetet hållna få:

• TIMEOUT - genereringen tog för lång tid och övergavs.
• MODERATION_REJECTED - förfrågan bröt mot innehållspolicyn.
• VENDOR_ERROR - något gick fel längre upp, på genereringssidan.
• UNKNOWN - en ärlig uppsamlingskod för allt som inte passar i de tre andra.

En liten, fast uppsättning koder är ett medvetet val - det är något du faktiskt kan skriva en switch-sats mot, i stället för att mönstermatcha mot fritextfel som kan ändras under dig.

Bilder går ut efter 30 dagar

Byten för en genererad bild sparas i 30 dagar. Därefter finns historikposten för genereringen kvar - din list-endpoint visar fortfarande att den hände, när och vad den kostade - men att hämta själva bildinnehållet ger HTTP 410 Gone. Det är en rak, inte gömd avvägning kring lagringskostnad: vill du behålla en bild längre än 30 dagar, ladda ner den och spara den själv. Vi raderar aldrig posten om genereringen i tysthet, bara byten.

Rate limits är inte det verkliga taket

Rate limiten per minut på din API-nyckel (som standard 20 anrop per minut för generering, 120 för läsningar) finns för att dämpa missbruk, inte för att vara det som faktiskt begränsar hur många bilder du kan göra. Ditt saldo i Fellowi Coins är det verkliga taket - har du coins kan du spendera dem, upp till den takten. Vill du ha en snävare budget än ditt saldo tillåter kan en nyckel också bära ett valfritt dagligt cointak som du sätter själv, för din egen kostnadskontroll snarare än vår.

Nycklar du inte får tillbaka

En API-nyckel visas för dig exakt en gång, när den skapas. Efter det lagras bara ett hashat värde och en kort förhandsvisning hos oss - samma hållning som vi har till varje annan hemlighet i produkten. Tappar du en nyckel skapar du en ny; det finns inget återställningsflöde, eftersom det inte finns något hos oss som kan återställa den.

Samma wallet, samma pris

API:et och webbappendras från exakt samma saldo i Fellowi Coins, till exakt samma pris per kvalitetsnivå - 40 coins för Standard, 60 för hög kvalitet. Det finns ingen separat “API-prissättning”. Det är avsiktligt: din kostnad är förutsägbar oavsett vilken dörr du genererar genom.

För de faktiska request- och responsformaten och fungerande kodexempel, se vår snabbstart för API:et, eller gå direkt till API Console för att skapa en nyckel.