API Console

Roep de generator van Fellowi Images aan vanuit je eigen code. Dezelfde modellen, dezelfde prijzen, dezelfde coins - alleen een API-sleutel in plaats van het webformulier.

Authenticatie

Elk verzoek heeft een API-sleutel nodig in de Authorization-header: Authorization: Bearer fk_live_.... Sleutels maak je hieronder aan en worden maar één keer getoond, bij het aanmaken - bewaar de jouwe dus goed.

Je API-sleutel

API-sleutel

Plak een sleutel en hij staat in elk voorbeeld op deze pagina, en je kunt de API hier uitproberen. Hij blijft in dit browsertabblad en gaat alleen naar de API van deze site.

Onthouden in dit tabblad

Modellen

Kies een model met het veld model. Prijzen gelden per afbeelding, in Fellowi-munten, en zijn precies wat de web-Image Studio rekent. Een lege images-lijst betekent tekst-naar-afbeelding; stuur je referenties mee, dan draait het verzoek op het bewerkingsmodel, dat anders kan kosten.

Laat je model weg, dan krijg je fellowi-text-to-image - hetzelfde model en dezelfde prijs die een integratie van voor deze keuze altijd al had.

curl https://fellowi.com/api/v1/api/models

Een afbeelding maken

POST /v1/api/images antwoordt meteen met 202 en een generatie in de wachtrij; de afbeelding zelf duurt tot een paar minuten. Stuur een Idempotency-Key-header mee, zodat een nieuwe poging nooit dubbel betaalt.

images is optioneel: tot 10 openbare afbeeldings-URL's waar het model van uitgaat (een companionfoto, je eigen referentie). Elke verhoogt de prijs met 10 munten, en een niet-lege lijst draait op het bewerkingsmodel in plaats van tekst-naar-afbeelding.

curl -X POST https://fellowi.com/api/v1/api/images \
  -H "Authorization: Bearer fk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "prompt": "a neon-lit cyberpunk portrait",
    "model": "fellowi-text-to-image",
    "quality": "standard",
    "format": "png",
    "aspectRatio": "1:1",
    "enhancePrompt": false,
    "enhanceStyle": "default",
    "images": []
  }'

Opties bij het verzoek

Alles hieronder is optioneel. Elke standaardwaarde is het gedrag dat de API had voordat die optie bestond, zodat een oudere integratie ongewijzigd blijft werken.

quality: standard of high. Bepaalt de resolutie en de prijs - zie de tabel hierboven.
format: png of jpeg. Standaard png.
aspectRatio: auto (standaard) of een van 1:1, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21.
enhancePrompt / enhanceStyle: Zet enhancePrompt op true om je prompt voor het renderen te laten herschrijven, voor 10 munten extra. enhanceStyle stuurt die herschrijving: default, artistic, photographic, technical, anime of realistic. Staat enhancePrompt uit, dan wordt het genegeerd.
images: Tot 10 openbaar bereikbare afbeeldings-URL's om van uit te gaan. Zodra je er een meestuurt, schakelt het verzoek over op het bewerkingsmodel. Elke referentieafbeelding in images kost 10 munten extra.

Het resultaat opvragen

Vraag GET /v1/api/images/{id} op tot status succeeded is en download dan imageUrl. Mislukte generaties worden automatisch terugbetaald.

curl https://fellowi.com/api/v1/api/images/{id} \
  -H "Authorization: Bearer fk_live_..."

Als een generatie mislukt

Een mislukte generatie betaalt haar munten terug en meldt een van vier codes in failureCode: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR of UNKNOWN. Meer detail publiceren we niet - een interne code zou iets over onze pijplijn zeggen in plaats van over jouw verzoek.

Limieten en kosten

Elke sleutel heeft een eigen limiet aan verzoeken per minuut (zichtbaar in het paneel hieronder) en kan een dagelijkse muntlimiet dragen. Dat zijn misbruikremmen, niet het echte plafond - wat je werkelijk begrenst is je saldo aan Fellowi-munten. 403 met een HTML-pagina: het verzoek is gestopt voordat het de API bereikte, meestal door de User-Agent. De standaard van Python-urllib wordt geblokkeerd, stuur een eigen, bijvoorbeeld User-Agent: my-app/1.0.