HiAPI
Blog

Benutzerhandbuch

Seedance 2.5 Flash – Integrationsleitfaden für referenzgestützte Videogenerierung: Referenzbilder, Referenzaudio und Abrechnungsregeln

Nov 17, 2026
Stacked sheets receding into shallow depth of field, cream and graphite with one terracotta sheet as accent.
Modell
seedance-2.5-flash
Auf dieser Seite

Was dieses Modell tut

seedance-2.5-flash/reference-to-video ist ein referenzmaterialgestütztes Videomodell von ByteDance. Sie übergeben ihm Referenzbilder und Referenzaudio und verweisen im Prompt mit @image1, @audio1 der Reihe nach darauf; das Modell erzeugt daraus ein neues Video. Referenzbilder bestimmen, wie Personen, Produkte oder Szenen aussehen, Referenzaudio gibt Rhythmus, Musik oder Sprechstimme vor.

Einschränkungen für Referenzmaterial

  • Referenzbilder: maximal 10 Stück, unterstützt jpeg, png, webp, bmp, tiff, gif, je unter 30 MB, Kantenlänge 300 bis 6000 Pixel, Seitenverhältnis 0,4 bis 2,5; SVG, HEIC und HEIF werden nicht unterstützt.
  • Referenzaudio: maximal 5 Segmente, wav oder mp3, unter 15 MB, je 2 bis 30 Sekunden, insgesamt höchstens 30 Sekunden; es kann auch nur Audio ohne Bilder übergeben werden.

Mindestens eine der beiden Materialarten muss angegeben werden, sonst ist die Anfrage ungültig.

Abrechnungsregeln

Dieser Endpunkt rechnet nach den Sekunden des Ausgabevideos ab; Referenzbilder und Referenzaudio zählen nicht zu den abgerechneten Sekunden:

  • 480p: 0,0679 $/Sekunde, ein 5-Sekunden-Video kostet etwa 0,34 $.
  • 720p: 0,1525 $/Sekunde, ein 5-Sekunden-Video kostet etwa 0,76 $.

Wird für die Dauer eine ganze Zahl von 4 bis 30 angegeben, wird nach den angegebenen Sekunden abgerechnet; bei -1 (automatisch) wird nach der tatsächlichen Länge des fertigen Videos aufgerundet, mindestens 4 Sekunden. Wer das Budget kontrollieren will, gibt feste Sekunden an.

Anfrageparameter

  • prompt (erforderlich): beschreibt, wie die Materialien verwendet werden, mit @image1, @audio1 in Reihenfolge referenziert, maximal 5000 Zeichen.
  • reference_image_urls / reference_audio_urls: URL-Arrays für Referenzbilder und Referenzaudio.
  • duration: ganze Zahl von 4 bis 30 oder -1 für automatisch; Standard 5.
  • resolution: 480p oder 720p, Standard 480p.
  • aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 oder adaptive entsprechend dem Referenzmaterial, Standard adaptive.
  • omni_reference_task_type: fest auf reference (Standardwert, kann weggelassen werden).
  • output_format: mp4 (Standard) oder mov; generate_audio: Standard true, erzeugt synchronisierte Dialoge, Soundeffekte und Hintergrundgeräusche.

Wie man den Prompt formuliert

Zuerst die Materialien in der Reihenfolge ihres Auftretens nummerieren, dann Punkt für Punkt erläutern, welche Rolle jedes Material übernimmt und wie das finale Bild aussehen soll. Zum Beispiel:

Das Produkt aus @image1 wird langsam rotierend auf einem Holztisch präsentiert, der Hintergrund ist das Morgenfenster aus @image2,
die Kamera fährt langsam von einer halbnahen Einstellung zur Nahaufnahme, der Bildrhythmus folgt dem Schlagzeug aus @audio1, die metallischen Glanzlichter des Produkts bleiben unverändert.

Bei mehreren Referenzbildern ist es deutlich stabiler, klar zu schreiben, welches das Hauptmotiv und welches die Szene oder der Stil ist, statt nur „verwende diese Bilder als Referenz“ zu schreiben. Wird Referenzaudio verwendet, sollte man angeben, an welcher Stelle des Audios sich die Bildbewegung orientieren soll.

Häufige Fragen

  • Anfrage abgelehnt wegen fehlendem Material: Mindestens ein Referenzbild oder Referenzaudio ist erforderlich.
  • Referenzbild lässt sich nicht hochladen: Zuerst prüfen, ob das Format in der unterstützten Liste steht, ob die Kantenlänge zwischen 300 und 6000 liegt und ob das Seitenverhältnis zwischen 0,4 und 2,5 liegt.
  • Audio abgelehnt: Einzelne Segmente müssen 2 bis 30 Sekunden lang und unter 15 MB sein, mehrere Segmente zusammen höchstens 30 Sekunden.
  • Kosten weichen von den Erwartungen ab: Prüfen, ob -1 für automatische Dauer verwendet wurde; die automatische Dauer wird nach den tatsächlichen Sekunden des fertigen Videos abgerechnet.

Empfehlungen zum Go-live

Zunächst mit einem Referenzbild und 5 Sekunden 480p einen Auftrag ausführen, um die Kette und die Abrechnungslogik zu prüfen; dann mit Referenzaudio oder mehreren Referenzbildern einen weiteren Auftrag ausführen und prüfen, ob das Bild die Materialien gemäß den Nummern im Prompt verwendet. Die Aufzeichnungen dieser beiden Aufträge als Basis behalten, damit man beim späteren Ändern von Prompt oder Materialien einen Vergleich hat. Parameter und Preise gelten gemäß der aktuellen Beschreibung auf der Modellseite.

Ähnliche Artikel

Alle Artikel ansehen →

Starte mit persistenten KI-Artefakten

Hol dir deinen API-Key und rufe Bild-, Video- und Audiomodelle über eine einzige task-basierte API auf.

API-Dokumentation lesen