Fellowi

API Console

Anropa Fellowi Images-generatorn från din egen kod. Samma modeller, samma priser, samma coin-plånbok - bara en API-nyckel i stället för webbformuläret.

Autentisering

Varje anrop behöver en API-nyckel i Authorization-headern: Authorization: Bearer fk_live_.... Nycklar skapas nedan och visas bara en gång, direkt när de skapas - spara din på ett säkert ställe.

Din API-nyckel

Klistra in en nyckel så hamnar den i varje exempel på sidan och du kan prova API:t härifrån. Den stannar i den här webbläsarfliken och skickas bara till den här webbplatsens API.

Modeller

Välj modell med fältet model. Priserna gäller per bild, i Fellowi-mynt, och är exakt vad webbens Image Studio tar. En tom images-lista betyder text-till-bild; skickar du referenser körs begäran i stället på redigeringsmodellen, som kan kosta annorlunda.

Utan model får du fellowi-text-to-image - samma modell och samma pris som en integration skriven före det här valet alltid har haft.

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

Skapa en bild

POST /v1/api/images svarar direkt med 202 och en generering i kö; själva bilden tar upp till några minuter. Skicka en Idempotency-Key-header så att ett nytt försök aldrig betalar två gånger.

images är valfritt: upp till 10 publika bild-URL:er som modellen utgår från (ett companionfoto, din egen referens). Varje lägger 10 mynt på priset, och en icke-tom lista körs på redigeringsmodellen i stället för text-till-bild.

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

Alternativ i begäran

Allt nedan är valfritt. Varje standardvärde är det beteende API:et hade innan alternativet fanns, så en äldre integration fortsätter fungera oförändrad.

quality
standard eller high. Bestämmer upplösning och pris - se tabellen ovan.
format
png eller jpeg. Standard är png.
aspectRatio
auto (standard) eller något av 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
Sätt enhancePrompt till true för att få din prompt omskriven före renderingen, för 10 mynt extra. enhanceStyle styr omskrivningen: default, artistic, photographic, technical, anime eller realistic. Den ignoreras när enhancePrompt är av.
images
Upp till 10 publikt nåbara bild-URL:er att utgå från. Skickar du någon byter begäran till redigeringsmodellen. Varje referensbild i images kostar 10 mynt extra.

Hämta resultatet

Polla GET /v1/api/images/{id} tills status är succeeded och ladda sedan ner imageUrl. Misslyckade genereringar återbetalas automatiskt.

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

När en generering misslyckas

En misslyckad generering återbetalar sina mynt och rapporterar en av fyra koder i failureCode: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR eller UNKNOWN. Något mer detaljerat publicerar vi inte - en intern kod skulle berätta om vår pipeline i stället för om din begäran.

Hastighetsgränser och kostnad

Varje nyckel har sin egen gräns för antal anrop per minut (syns i panelen nedan) och kan ha ett dagligt mynttak. Det är skydd mot missbruk, inte det verkliga taket - det som faktiskt begränsar dig är ditt saldo av Fellowi-mynt. 403 med en HTML-sida: begäran stoppades innan den nådde API:et, oftast på grund av User-Agent. Standardvärdet i Python-urllib blockeras, skicka ett eget, till exempel User-Agent: my-app/1.0.