Mit FlowModels erzeugst du kurze Videos aus einer Textbeschreibung oder aus einem Startbild. Ein Video entsteht im Hintergrund: Du startest einen Auftrag, wir reservieren den Betrag, und sobald das Video fertig ist, kannst du es abspielen oder herunterladen. Das geht im Playground im Dashboard oder direkt über die API.
Die Modelle
| Modell | Eingabe | Dauer | Auflösung | Ton |
|---|---|---|---|---|
bytedance/seedance-2.5/text-to-video |
Prompt | 4 bis 30 Sekunden | 480p, 720p, 1080p |
ja |
bytedance/seedance-2.5/image-to-video |
Startbild, Prompt optional | 4 bis 30 Sekunden | 480p, 720p, 1080p |
ja |
minimax/h3/text-to-video |
Prompt | 5 bis 15 Sekunden | 2K |
nein |
minimax/h3/image-to-video |
Startbild und Prompt | 5 bis 15 Sekunden | 2K |
nein |
alibaba/wan-3.0/text-to-video |
Prompt | 2 bis 30 Sekunden | 480p, 720p, 1080p |
ja |
alibaba/wan-3.0/image-to-video |
Startbild und Prompt | 2 bis 30 Sekunden | 480p, 720p, 1080p |
ja |
Alle Bild-zu-Video-Modelle nehmen zusätzlich ein Endbild an. Verwende nur Modelle, die in deiner Antwort von GET /v1/models mit der Art video auftauchen. Dort stehen unter video die erlaubten Werte je Modell und unter pricing.variants die Preise je Sekunde. Es gibt keinen automatischen Wechsel auf ein anderes Modell.
Im Playground
Öffne im Dashboard den Playground und dort den Reiter Videos. Wähle das Modell, beschreibe die Szene im Feld Prompt und lege Dauer in Sekunden und Auflösung fest. Je nach Modell kommen Seitenverhältnis, Ausgabeformat, Ton erzeugen, Denkmodus, KI-Wasserzeichen einfügen oder Seed (optional) dazu. Bei Bild zu Video lädst du ein Startbild hoch und auf Wunsch ein Endbild (JPEG, PNG, WebP oder GIF, bis 10 MB).
Unter Reservierung siehst du vor dem Start, welcher Betrag für deine Auswahl zurückgelegt wird, und den Preis je Sekunde. Mit Video erzeugen startest du den Auftrag.

Unter Deine Videos stehen alle Videos deines Teams, auch die über die API gestarteten. Solange ein Video läuft, aktualisiert sich die Liste von selbst. Fertige Videos spielst du direkt ab oder lädst sie herunter, ein noch wartendes Video kannst du abbrechen, ein beendetes löschen. Prompts zeigt die Liste nicht an, weil sie für das ganze Team sichtbar ist. Abgerechnet wird über das FlowModels-Guthaben deines Teams, einen API-Schlüssel brauchst du dafür nicht. In Verbrauch und Anfragen erscheinen deine Aufrufe unter „Playground · dein Name“.
Was die anderen Reiter des Playgrounds können und welche Grenzen dort gelten, steht in Modelle im Playground ausprobieren.
Per API
Schick den Auftrag an POST /v1/videos:
curl https://api.flowmodels.one/v1/videos \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: video-sommerkampagne-01" \
-d '{"model": "bytedance/seedance-2.5/text-to-video", "prompt": "Ein Papierboot auf einem ruhigen See bei Sonnenaufgang", "duration": 5, "resolution": "720p"}'
Die API antwortet sofort mit HTTP 202 und einem Auftrag mit id und status queued. Mit demselben Idempotency-Key kannst du die Anfrage nach einem Netzwerkfehler gefahrlos wiederholen, es entsteht kein zweites Video.
Die wichtigsten Felder:
modelundprompt: Der Prompt ist bei allen Text-zu-Video-Modellen und bei MiniMax und Wan für Bild zu Video Pflicht, höchstens 7.000 Zeichen.image_urloderimage_file_id: das Startbild alshttps-Adresse, alsdata:-URL oder als Datei-ID ausPOST /v1/files. Für das Endbild gibt esend_image_urlundend_image_file_id.duration,resolution,aspect_ratio: Dauer in Sekunden (Standard 5), Auflösung und Seitenverhältnis im Rahmen des Modells. Seedance Bild zu Video folgt dem Seitenverhältnis des Bildes.generate_audio(Seedance und Wan),output_formatmitmp4odermov(nur Seedance Text zu Video),enable_thinkingundseed(nur Wan),aigc_watermark(nur MiniMax).
Ein Feld, das das Modell nicht kennt, lehnt die API mit 422 und dem Feldnamen in param ab, bevor etwas reserviert wird.
Status und Abruf
- Frag den Auftrag mit
GET /v1/videos/{id}ab, höchstens alle fünf Sekunden. Alternativ meldet ein Webhook die Ereignissevideo.completed,video.failedundvideo.cancelled, siehe Webhooks von FlowModels einrichten. statussteht zuerst aufqueued, dann aufin_progressund am Ende aufcompleted,failedodercancelled.- Ist das Video fertig, enthält die Antwort
content_url,content_typeundsize_bytes.GET /v1/videos/{id}/contentantwortet mit 302 auf eine Download-Adresse, die 15 Minuten gilt.
GET /v1/videos listet die Aufträge deines Teams, mit limit, after und status blätterst und filterst du.
Mit POST /v1/videos/{id}/cancel brichst du einen Auftrag ab, solange die Erzeugung noch nicht begonnen hat, die Reservierung wird dann freigegeben. Läuft sie schon, antwortet die API mit 409 video_not_cancellable, das Video wird fertig erzeugt und berechnet.
Aufbewahrung
Ein fertiges Video bleibt sieben Tage ab Fertigstellung abrufbar, expires_at nennt den genauen Zeitpunkt. Danach löschen wir Video und Auftrag automatisch. Mit DELETE /v1/videos/{id} oder im Playground löschst du ein beendetes Video früher.
Was ein Video kostet
Videos werden je Sekunde berechnet. Der Preis hängt vom Modell, der Auflösung, dem Ton und bei Wan vom Denkmodus ab. Den aktuellen Preis siehst du unter Modelle und in GET /v1/models unter pricing.variants.
Beim Start legen wir den Preis fest und reservieren die volle angeforderte Länge. Abgebucht wird erst, wenn das fertige Video bei uns gespeichert ist. Fehlgeschlagene, abgelehnte und abgebrochene Aufträge kosten nichts. Was berechnet wurde, steht im fertigen Auftrag unter usage.cost.
Grenzen
- Wie viele Videos dein Team gleichzeitig laufen lassen kann, hängt von deiner Stufe beim Anfragelimit ab: 3, 5, 10 oder 20. Siehe Anfragelimit: So funktionieren die Stufen.
- Start- und Endbilder dürfen höchstens 10 MiB groß sein.
- Die erzeugten Videos sind KI-generiert. Kennzeichne sie entsprechend, wenn du sie veröffentlichst.
Wenn etwas nicht klappt
422 invalid_video_request: Ein Feld passt nicht zum Modell,paramnennt es.422 video_input_invalid: Das Bild fehlt, ist ungültig, zu groß oder gehört nicht zu deinem Team.429 insufficient_quotaoder429 spend_limit_exceeded: Guthaben oder Ausgabenlimit reichen für die Reservierung nicht aus.429 video_concurrency_exceeded: Es laufen schon zu viele Videos. Warte die Zeit ausRetry-Afterab.503 video_model_unavailable,503 video_pricing_unavailableoder503 video_provider_unavailable: Versuche es später erneut, dein Guthaben wurde nicht belastet.404 video_not_found: Die ID ist unbekannt oder gehört nicht zu deinem Team.409 video_not_readyoder409 video_not_deletable: Der aktuelle Status lässt die Aktion noch nicht zu.- Auftrag
failed:error.codenennt den Grund, zum Beispielvideo_generation_failedodervideo_content_rejected. In seltenen Fällen, etwa beivideo_submit_uncertain, bleibt der Betrag reserviert, bis wir den Fall geprüft haben.