HiAPI
This article isn't available in your language yet; showing the original.
Blog

Benutzerhandbuch

Seedance 2.5 Flash Bild-zu-Video-Integrationsleitfaden: Erstes Frame, letztes Frame und sekundengenaue Abrechnung

Ein Bild in Bewegung bringen: Parameter, Preise und häufige Fehlerursachen

Nov 17, 2026
Ein diskretes Punktmuster in Mintgrün auf schwarzem Grund, dessen Punktdichte von links nach rechts allmählich zunimmt.
Model
seedance-2.5-flash
On this page

Was dieses Modell leistet

seedance-2.5-flash/image-to-video ist ein Bild-zu-Video-Modell von ByteDance: Man lädt ein Bild als erstes Frame hoch, das Modell erzeugt ausgehend davon ein durchgehendes Video und generiert synchron dazu Audio. Das Seitenverhältnis folgt dem ersten Frame, es findet kein nachträglicher Beschnitt statt.

Es eignet sich für Szenarien, die auf deterministischem Ausgangsmaterial basieren: die dynamische Präsentation von Produktbildern, Mikroexpressionen und Körperbewegungen von Charakter-Illustrationen, die animierte Vorschau von Storyboard-Skizzen sowie Kurzfilme, die einen Content-Pool in großer Zahl füllen müssen. Es eignet sich nicht für Anforderungen, bei denen „ein einziger Satz ein vollständiges Narrativ erzeugen soll“ – das ist die Aufgabe der Text-zu-Video-Route.

Anfrageparameter

  • prompt (erforderlich): beschreibt die gewünschte Bewegung, Kameraführung, Szene und den Ton, maximal 5000 Zeichen.
  • first_frame_url (erforderlich): das Bild des ersten Frames. Unterstützt jpeg, png, webp, bmp, tiff, gif, heic, heif, maximal 30 MB pro Bild, 300 bis 6000 Pixel pro Seite, Seitenverhältnis 0,4 bis 2,5.
  • last_frame_url (optional): das Bild des letzten Frames, mit denselben Vorgaben wie das erste Frame; bei abweichendem Verhältnis wird mittig beschnitten und ausgerichtet. Wird ein letztes Frame übergeben, muss gleichzeitig auch ein erstes Frame übergeben werden.
  • resolution: 480p oder 720p, Standard 480p.
  • duration: eine ganze Zahl von 4 bis 30, Standard 5, Einheit Sekunden.
  • aspect_ratio: akzeptiert nur adaptive, das Ausgabeverhältnis folgt dem Bild des ersten Frames.
  • output_format: mp4 (Standard) oder mov.
  • generate_audio: Standard true.

Sekundengenaue Abrechnung

  • 480p: $0,0679/Sekunde
  • 720p: $0,1525/Sekunde

Die abgerechneten Sekunden entsprechen der angeforderten duration. Häufige Stufen: 480p 4 Sekunden $0,2716, 720p 4 Sekunden $0,61, 480p 10 Sekunden $0,679, 720p 10 Sekunden $1,525. Die Bilder des ersten und letzten Frames werden selbst nicht zusätzlich berechnet.

Da sekundengenau abgerechnet wird, bedeutet ein erneuter Versuch eine erneute Zahlung. Die Frage „Ist das erste Frame geeignet?“ vor dem Absenden zu klären, ist deutlich günstiger, als nach der Generierung neu zu starten.

Das erste Frame bestimmt die Obergrenze des Ergebnisses

Das Modell kann nur auf Basis der im ersten Frame vorhandenen Informationen weiterentwickeln, daher bestimmt die Qualität des ersten Frames nahezu die Obergrenze des Ergebnisses:

  • Das Motiv ist klar und nimmt einen angemessenen Anteil im Bild ein – ist das Motiv zu klein, kann das Modell kaum beurteilen, was sich bewegen soll.
  • Starke Unschärfe und Bildrauschen vermeiden; minderwertige Eingaben werden in jedem Frame verstärkt.
  • Bildränder beachten: abgeschnittene Motive verformen sich bei Bewegung leicht.
  • Text im Bild lässt sich in Bewegung schwer stabil halten, es sei denn, er ist ohnehin nicht wichtig.
  • Mehrere Kandidatenbilder für das erste Frame desselben Motivs vorzubereiten ist effektiver, als wiederholt den Prompt anzupassen.

Die Dauer ist sowohl Kostenfaktor als auch Qualitätsvariable

Je länger der Clip, desto mehr Frames muss das Modell konsistent halten, und desto höher ist die kumulierte Wahrscheinlichkeit von Drift und Verzerrung. Es empfiehlt sich, zunächst mit 4 bis 5 Sekunden zu prüfen, ob das erste Frame und die Bewegungsrichtung stimmig sind, und erst nach der Bestätigung bei Bedarf zu verlängern; lange Inhalte organisiert man besser als „mehrere kurze Clips + Nachbearbeitung/Montage“ statt sich auf eine einzelne lange Generierung zu verlassen.

Häufige Fehler und Reihenfolge der Fehlersuche

  1. Bereits beim Absenden Parameterfehler: Zuerst prüfen, ob das Bild die Grenzen überschreitet (Größe, Seitenlänge, Seitenverhältnis, Format) und ob nur last_frame_url ohne erstes Frame übergeben wurde.
  2. Verformung des Motivs im Bild: Meist ist das Motiv im ersten Frame zu klein, am Rand abgeschnitten oder die geforderte Bewegungsamplitude zu groß. Erstes Frame wechseln oder die Bewegung kleiner formulieren.
  3. Verhältnis weicht von der Erwartung ab: Diese Route ist fest auf adaptive eingestellt, die Ausgabe folgt dem ersten Frame; wer 16:9 oder 9:16 möchte, legt dies bereits im ersten Frame fest.
  4. Inhalt wird blockiert: Auch das erste Frame selbst muss die Compliance-Prüfung bestehen; was im Bild ist, entscheidet unmittelbar darüber, ob der Aufruf zustande kommt.
  5. Client-Timeout, obwohl die Aufgabe eigentlich erfolgreich war: Die Videogenerierung dauert länger; ein zu kurz gesetztes Client-Timeout behandelt einen Erfolg als Fehler, und erneutes Absenden wird erneut berechnet. Als asynchrone Aufgabe behandeln und ausreichend Timeout einplanen.

Empfehlungen für den Produktivbetrieb

Zunächst mit drei bis fünf ersten Frames unterschiedlicher Art die gesamte Kette durchlaufen und prüfen, ob Absenden, Polling und Download vollständig funktionieren; dann das erste Frame fixieren und nur den Prompt ändern, um herauszufinden, auf welche Bewegungsbeschreibungen das Modell gut reagiert; schließlich die Menge proportional hochfahren und Erfolgsquote, durchschnittliche Dauer und Wiederholungsrate im Blick behalten. Parameter und Preise richten sich nach den aktuellen Angaben auf der Modellseite.

Related articles

View all articles →

Start building with persistent AI artifacts

Get your API key and call image, video and audio models through one task-based API.

Read the API docs