Fellowi

API-Konsole

Ruf den Fellowi-Images-Generator direkt aus deinem eigenen Code auf. Gleiche Modelle, gleiche Preise, gleiches Coin-Guthaben - nur statt des Webformulars ein API-Schlüssel.

Authentifizierung

Jede Anfrage braucht einen API-Schlüssel im Authorization-Header: Authorization: Bearer fk_live_.... Schlüssel werden weiter unten erstellt und nur einmal, direkt bei der Erstellung, angezeigt - bewahre deinen sicher auf.

Dein API-Schlüssel

Füge einen Schlüssel ein, dann steht er in jedem Beispiel auf dieser Seite und du kannst die API direkt hier ausprobieren. Er bleibt in diesem Browser-Tab und geht nur an die API dieser Website.

Modelle

Wähle ein Modell über das Feld model. Die Preise gelten pro Bild in Fellowi-Coins und entsprechen genau dem, was das Web-Image-Studio berechnet. Eine leere images-Liste bedeutet Text-zu-Bild; mit Referenzen läuft die Anfrage stattdessen auf dem Bearbeitungsmodell, das anders kosten kann.

Ohne model bekommst du fellowi-text-to-image - dasselbe Modell und denselben Preis, den eine vor dieser Wahl geschriebene Integration immer hatte.

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

Ein Bild erzeugen

POST /v1/api/images antwortet sofort mit 202 und einer Generierung in der Warteschlange; das Bild selbst braucht bis zu ein paar Minuten. Sende einen Idempotency-Key-Header, damit ein Wiederholungsversuch nie doppelt bezahlt.

images ist optional: bis zu 10 öffentliche Bild-URLs, von denen das Modell ausgeht (ein Companion-Foto, deine eigene Referenz). Jede erhöht den Preis um 10 Coins, und eine nicht leere Liste läuft auf dem Bearbeitungsmodell statt auf Text-zu-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": []
  }'

Anfrage-Optionen

Alles Folgende ist optional. Jeder Standardwert entspricht dem Verhalten der API, bevor es die jeweilige Option gab, damit eine ältere Integration unverändert weiterläuft.

quality
standard oder high. Bestimmt Auflösung und Preis - siehe Tabelle oben.
format
png oder jpeg. Standard ist png.
aspectRatio
auto (Standard) oder eines von 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
Setze enhancePrompt auf true, damit dein Prompt vor dem Rendern umgeschrieben wird, für 10 Coins zusätzlich. enhanceStyle steuert diese Umschreibung: default, artistic, photographic, technical, anime oder realistic. Ohne enhancePrompt wird es ignoriert.
images
Bis zu 10 öffentlich erreichbare Bild-URLs als Vorlage. Sobald eine dabei ist, wechselt die Anfrage auf das Bearbeitungsmodell. Jedes Referenzbild in images kostet zusätzlich 10 Coins.

Ergebnis abfragen

Frage GET /v1/api/images/{id} ab, bis status succeeded ist, und lade dann imageUrl herunter. Fehlgeschlagene Generierungen werden automatisch erstattet.

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

Wenn eine Generierung fehlschlägt

Eine fehlgeschlagene Generierung erstattet ihre Coins und meldet einen von vier Codes in failureCode: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR oder UNKNOWN. Genaueres veröffentlichen wir nicht - ein interner Code würde etwas über unsere Pipeline verraten statt über deine Anfrage.

Ratenlimits und Kosten

Jeder Schlüssel hat sein eigenes Limit an Anfragen pro Minute (im Panel unten sichtbar) und kann ein tägliches Coin-Limit tragen. Das sind Missbrauchsbremsen, nicht die eigentliche Grenze - begrenzt wirst du in Wahrheit nur durch dein Fellowi-Coins-Guthaben. 403 mit einer HTML-Seite: Die Anfrage wurde gestoppt, bevor sie die API erreichte, meist wegen des User-Agent. Der Standardwert von Python-urllib wird blockiert, senden Sie einen eigenen, zum Beispiel User-Agent: my-app/1.0.