FlowModels

Videos erzeugen: Playground, API, Modelle und Kosten

Veröffentlicht am 13. November 2026

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.

Der Playground für Videos mit Formular, Reservierung und der Liste der Videos

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:

  • model und prompt: 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_url oder image_file_id: das Startbild als https-Adresse, als data:-URL oder als Datei-ID aus POST /v1/files. Für das Endbild gibt es end_image_url und end_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_format mit mp4 oder mov (nur Seedance Text zu Video), enable_thinking und seed (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

  1. Frag den Auftrag mit GET /v1/videos/{id} ab, höchstens alle fünf Sekunden. Alternativ meldet ein Webhook die Ereignisse video.completed, video.failed und video.cancelled, siehe Webhooks von FlowModels einrichten.
  2. status steht zuerst auf queued, dann auf in_progress und am Ende auf completed, failed oder cancelled.
  3. Ist das Video fertig, enthält die Antwort content_url, content_type und size_bytes. GET /v1/videos/{id}/content antwortet 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, param nennt es.
  • 422 video_input_invalid: Das Bild fehlt, ist ungültig, zu groß oder gehört nicht zu deinem Team.
  • 429 insufficient_quota oder 429 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 aus Retry-After ab.
  • 503 video_model_unavailable, 503 video_pricing_unavailable oder 503 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_ready oder 409 video_not_deletable: Der aktuelle Status lässt die Aktion noch nicht zu.
  • Auftrag failed: error.code nennt den Grund, zum Beispiel video_generation_failed oder video_content_rejected. In seltenen Fällen, etwa bei video_submit_uncertain, bleibt der Betrag reserviert, bis wir den Fall geprüft haben.

War dieser Artikel hilfreich?

Zurück zu Modelle, Limits & Fehler