Die Fellowi-API macht jetzt Video: Keys, Modelle, erster Request

Bis vor Kurzem konnte die Fellowi-API genau eines: Text rein, Bild raus. Inzwischen kann sie deutlich mehr. Derselbe Key erzeugt Videoclips, Sie wählen das Modell für Bilder und Video, und die API Console listet jedes davon mit Preis auf, damit niemand raten muss. Wenn Ihr Produkt Bilder oder kurze Bewegung braucht und Sie dafür keine eigene GPU-Farm betreiben wollen, ist dieser Text für Sie.

Was sich geändert hat, kurz

• Video mit demselben Key. Image-to-Video, Text-to-Video und Clips nach Referenzbildern, mit demselben Guthaben und derselben Request-Form wie Bilder.
• Ein Feld model. Ein schnelleres, günstigeres Modell für Entwürfe und ein stärkeres für das finale Rendering. Bei Bildern dürfen Sie es weglassen und bekommen genau das, was eine ältere Integration immer bekommen hat, zum selben Preis; ein Video-Request nennt sein Modell immer.
• Ein Katalog, den Code lesen kann. GET /v1/api/models liefert, was Ihr Key aufrufen darf und was es kostet, sodass Ihre App eine eigene Modellauswahl bauen kann statt einer Liste, die veraltet.
• Eine Abkürzung für die Integration selbst.Die Console hat einen Button „Copy for ChatGPT/Claude", der die komplette Referenz auf einmal kopiert. Fügen Sie sie in Ihren Coding-Assistenten ein und lassen Sie sich einen Client in Ihrer Sprache schreiben.

Einen Key holen

Legen Sie ein kostenloses Konto an, öffnen Sie /api-console, benennen Sie einen Key und erstellen Sie ihn. Der vollständige Key wird genau einmal angezeigt; danach speichert die Console nur eine Vorschau, also legen Sie ihn sofort in Ihren Secret-Store. Jeder Request schickt ihn als Bearer-Header:

Authorization: Bearer fk_live_your_key_here

Nutzen Sie einen Key pro Umgebung oder pro Produkt. Jeder Key kann ein eigenes tägliches Coin-Limit haben, der einfachste Weg, damit ein Fehler in einer Staging-Schleife nicht über Nacht das ganze Guthaben verbraucht.

Das erste Bild

Eine Generierung läuft asynchron. Sie reihen sie ein, bekommen sofort 202 zurück, und das Bild kommt etwas später:

POST /v1/api/images
Content-Type: application/json
Authorization: Bearer fk_live_your_key_here
Idempotency-Key: 7f1c2b90-order-4411

{
  "prompt": "a ceramic mug on a linen cloth, soft window light",
  "quality": "standard",
  "aspectRatio": "4:5"
}

Der Header Idempotency-Key ist wichtiger, als er aussieht. Netzwerke verlieren Antworten; mit dem Header liefert ein erneuter Versuch derselben Anfrage dieselbe Generierung, statt doppelt zu bezahlen. Erzeugen Sie ihn pro Versuch, etwa aus Ihrer eigenen Bestell-ID. Dann fragen Sie ab, bis es fertig ist, und laden das Ergebnis:

GET /v1/api/images/{id}          -> "queued" ... "succeeded"
GET /v1/api/images/{id}/content  -> the image bytes

quality, format, aspectRatio und ein optionaler, kostenpflichtiger Prompt-Enhancer sind alle optional, und jeder Standardwert ist das, was die API vor dieser Option tat. Geben Sie in images ein paar URLs von Referenzbildern mit, läuft der Request über das Bearbeitungsmodell, so bleibt eine Figur oder ein Produkt über mehrere Bilder hinweg wiedererkennbar.

Ein Modell wählen

GET /v1/api/models

Das liefert die Bild- und Videomodelle, die Ihr Key nutzen darf, mit Coin-Preisen und für Video mit der maximalen Cliplänge, den verfügbaren Auflösungen und der Angabe, ob ein Startbild nötig ist. Übergeben Sie das gewünschte als model. Ein sinnvolles Muster: ein günstiges Modell, solange ein Nutzer ausprobiert, und das stärkere für die Version, die er behält. Aktuelle Zahlen stehen auch auf der Produktseite, die sie aus demselben Code liest, der Ihnen die Coins abbucht.

Der erste Clip

Image-to-Video beginnt mit einem Standbild. Laden Sie es einmal hoch und merken Sie sich die ID:

POST /v1/api/uploads
{ "imageBase64": "<your start frame, base64>" }

-> { "upload": { "id": "..." } }

Dann reihen Sie den Clip ein, genau wie ein Bild:

POST /v1/api/videos
Idempotency-Key: 7f1c2b90-clip-4411

{
  "model": "fellowi-image-to-video-turbo",
  "uploadId": "<id from /v1/api/uploads>",
  "prompt": "steam rises slowly from the mug, the camera drifts in",
  "durationSec": 5,
  "resolution": "720p",
  "generateAudio": false
}

Fragen Sie GET /v1/api/videos/{id} ab, bis der Status succeeded ist, und laden Sie videoUrl. Ein Clip dauert Minuten, nicht Sekunden, also fragen Sie behutsam ab und sagen Sie es Ihren Nutzern. Text-to-Video-Modelle brauchen gar keinen Upload. Der Preis gilt pro Sekunde Clip in der gewählten Auflösung; Ton und zusätzliche Referenzbilder kommen obendrauf, wo ein Modell sie unterstützt. API-Clips werden immer mit Coins bezahlt; das Kontingent eines Director-Plans gilt nur im Web-Videostudio.

Einbau in ein echtes Produkt

• Der Key bleibt auf Ihrem Server. Geben Sie ihn nie an einen Browser oder eine mobile App. Ihr Backend ruft uns auf, Ihr Frontend ruft Ihr Backend auf.
• Behandeln Sie es als Job-Queue. Speichern Sie die Generierungs-ID bei Ihrem Datensatz, fragen Sie aus einem Worker ab und legen Sie eine eigene Kopie der Datei ab, sobald sie da ist. Unsere Kopie dient der Auslieferung, nicht als Ihr Archiv.
• Fehler sind ein normales Ergebnis. Eine fehlgeschlagene Generierung erstattet ihre Coins von selbst und meldet einen von vier Codes: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR oder UNKNOWN. Zeigen Sie für jeden etwas Hilfreiches an und lassen Sie es erneut versuchen.
• Beachten Sie das Rate-Limit pro Key. Es ist ein Schutz vor Missbrauch, kein Kontingent, und steht in der Console neben jedem Key. Die eigentliche Grenze ist Ihr Coin-Guthaben.

Preise und Erstattungen erklären wir ausführlicher in warum die API in Coins abrechnet, die Erwachseneninhalte derselben API in unserem Leitfaden zur API für Charaktergenerierung.

Was sie nicht kann

Webhooks gibt es noch nicht: Sie fragen ab. Eine Gratisstufe gibt es nicht: Jeder Aufruf kostet Coins, zum selben Preis wie im Studio. Was die Moderation ablehnt, wird nicht gerendert, und Erwachseneninhalte gehören nicht auf öffentliche Plattformen, egal was Ihre App ist. Und obwohl unsere Bedingungen die kommerzielle Nutzung des Generierten nicht einschränken, versprechen wir nicht, dass ein Bild einzigartig oder frei von allen Rechten Dritter ist. Behandeln Sie es wie Stockmaterial, das Sie nicht selbst fotografiert haben. Wenn das zu dem passt, was Sie bauen, ist die Console der Ausgangspunkt.