API Console

Volej generátor Fellowi Images z vlastního kódu. Stejné modely, stejné ceny, stejná peněženka coinů - jen API klíč místo webového formuláře.

Autentizace

Každý požadavek potřebuje API klíč v hlavičce Authorization: Authorization: Bearer fk_live_.... Klíče vytvoříš níž a zobrazí se jen jednou při vytvoření - ulož si ten svůj někam do bezpečí.

Váš klíč API

Klíč API

Vložte klíč a doplní se do všech příkladů na stránce a API si můžete vyzkoušet přímo tady. Klíč zůstává v této záložce prohlížeče a posílá se jen do API tohoto webu.

Zapamatovat v této záložce

Modely

Model vyberete polem model. Ceny jsou za obrázek, v mincích Fellowi, a odpovídají přesně tomu, co účtuje webové Image Studio. Prázdný seznam images znamená text-to-image; pokud pošlete reference, požadavek běží na modelu pro úpravy, který může stát jinak.

Bez pole model dostanete fellowi-text-to-image - stejný model a stejnou cenu, jakou integrace napsaná před touto volbou měla vždycky.

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

Vytvořit obrázek

POST /v1/api/images vrátí okamžitě 202 s generováním ve frontě; samotný obrázek trvá až několik minut. Posílejte hlavičku Idempotency-Key, aby opakovaný pokus nikdy nezaplatil dvakrát.

images je volitelné: až 10 veřejných URL obrázků, ze kterých model vychází (fotka společníka, vlastní reference). Každý přidá k ceně 10 mincí a neprázdný seznam přepne generování na model pro úpravy místo text-to-image.

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": []
  }'

Volby požadavku

Vše níže je volitelné. Každá výchozí hodnota odpovídá chování API předtím, než daná volba existovala, takže starší integrace funguje beze změny.

quality: standard nebo high. Určuje rozlišení a cenu - viz tabulka výše.
format: png nebo jpeg. Výchozí je png.
aspectRatio: auto (výchozí) nebo jeden z 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: Nastavte enhancePrompt na true, aby se váš prompt před vykreslením přepsal, za 10 mincí navíc. enhanceStyle určuje směr přepisu: default, artistic, photographic, technical, anime nebo realistic. Při vypnutém enhancePrompt se ignoruje.
images: Až 10 veřejně dostupných URL obrázků jako východisko. Jakmile nějaký pošlete, požadavek se přepne na model pro úpravy. Každý referenční obrázek v images přidá 10 mincí navíc.

Dotazovat se na výsledek

Dotazujte se na GET /v1/api/images/{id}, dokud status nebude succeeded, a pak stáhněte imageUrl. Neúspěšná generování se automaticky vracejí v mincích.

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

Když generování selže

Neúspěšné generování vrátí mince a nahlásí jeden ze čtyř kódů v failureCode: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR nebo UNKNOWN. Nic podrobnějšího nezveřejňujeme - interní kód by mluvil o našem zpracování, ne o vašem požadavku.

Limity a cena

Každý klíč má vlastní limit požadavků za minutu (vidíte ho v panelu níže) a může mít denní strop v mincích. To jsou pojistky proti zneužití, ne skutečný strop - reálně vás omezuje jen zůstatek mincí Fellowi. 403 s HTML stránkou: požadavek byl zastaven dříve, než dorazil k API, obvykle kvůli User-Agent. Výchozí hodnota Python-urllib je blokována, pošlete vlastní, například User-Agent: my-app/1.0.