ByteDance
Seedance 2.5
seedance-2.5/reference-to-video
Byte Seeds gemeinsames Audio-Video-Generierungsmodell, das durchgehende Clips von bis zu 30 Sekunden und bis zu 4K unterstützt und dank multimodaler Referenzen und Bearbeitung auf Zeitstempel-Ebene eine präzise Steuerung des Bildes ermöglicht
seedance-2.5/reference-to-video ausprobieren
Eingabe
Galerie
Alle Arbeiten ansehenAusgabe
videoPreise
seedance-2.5/reference-to-video per second
| Spezifikationen | Einzelpreis |
|---|---|
| 480P | $0.1215 |
| 720P | $0.2715 |
| 1080P | $0.680 |
Positionsübersicht
Die referenzbasierte Videogenerierungs-Route von Seedance 2.5 richtet sich an Videogenerierungsaufgaben, bei denen die Bildkonsistenz durch Materialien eingeschränkt werden soll. Entwickler reichen einen Prompt sowie mindestens ein Referenzvideo ein und können zusätzlich Bild- und Audioreferenzen beifügen, damit das Modell die Materialien in der Reihenfolge @image1, @video1, @audio1 referenziert und ein fertiges Video von 4 bis 30 Sekunden in 480p bis 1080p erzeugt. Geeignet für Werbe-, Kurzfilm- und Markeninhalts-Teams, die bei seriellen Produktionen Charaktere, Produkte und Szenenaussehen fixieren wollen, sowie für narrative Sequenzen, die synchronisierte Soundeffekte und Dialoge benötigen.
Kernhighlights
- Multimodale Materialien schränken das Bild gemeinsam ein – bis zu 30 Bilder, 10 Videos und 10 Audioclips können gleichzeitig als Referenz dienen, um Produkte, Charaktere und Szenenaussehen zu fixieren.
- Prompts referenzieren Materialien in Reihenfolge – im Prompt werden Referenzelemente in der Reihenfolge @image1, @video1, @audio1 angegeben, um Materialien und Bildziele eindeutig zuzuordnen.
- Dauer und Bildformat steuerbar – die Ausgabedauer kann zwischen 4 und 30 Sekunden gewählt oder vom Modell automatisch bestimmt werden; das Bildformat reicht von 16:9 und 9:16 bis 21:9 sowie adaptiv je nach Material.
- Synchronisierte Audio-Video-Generierung – standardmäßig werden synchron zum Bild Dialoge, Soundeffekte und Hintergrundaudio erzeugt; dies kann deaktiviert werden, um reine Bildausgabe zu erhalten.
Funktionsbeschreibung
Generierung durch Referenzvideos: Mindestens ein Referenzvideo wird eingegeben, anhand dessen das Modell einen neuen Clip erzeugt, statt das Original zu verlängern oder zu schneiden; geeignet für Produktionen, die bestehende Kamerasprache und Bildqualität wiederverwenden wollen.
Gemischt Referenzen aus Bildern und Videos: bis zu 30 Bilder und bis zu 10 Videos, die kombiniert eingereicht werden können, um Charaktere, Produkte und Szenen separat einzuschränken und das Aussehens-Driften serieller Inhalte zu reduzieren.
Audioreferenz und Audiogenerierung: bis zu 10 wav- oder mp3-Audioreferenzen können beigefügt werden (müssen zusammen mit mindestens einem Referenzvideo eingereicht werden); zudem kann gewählt werden, ob synchronisierte Dialoge, Soundeffekte und Hintergrundgeräusche erzeugt werden.
Auflösungs- und Ausgabeformatoptionen: Die Ausgabe unterstützt 480p, 720p und 1080p; als Format stehen mp4 oder mov für die professionelle Postproduktion zur Wahl; die Abrechnung erfolgt nach Ausgabesekunden.
Ergänzende Informationen durch Websuche: web_search kann aktiviert werden, damit das Modell vor der Generierung zeitkritische Informationen aus dem Prompt recherchiert; geeignet für Inhalte, die aktuelle Fakten zitieren müssen.
Anwendungsszenarien
- Werbe- und Markenteams erstellen Produktclips – Produktbilder und Referenzvideos aus realen Drehs schränken das Aussehen ein, um 4- bis 30-sekündige Werbeclips für Werbematerial und Social-Media-Distribution zu erzeugen.
- Kurzfilm-Teams wahren Charakterkonsistenz – Charakterbilder und bestehende Clips dienen als Referenz, um in Serie aufeinanderfolgende Einstellungen desselben Charakters zu generieren, die für den Schnitt zusammengefügt werden.
- Postproduktionsteams proben Kameraeinstellungen – Szenenreferenzvideos und Kompositionsbilder werden eingereicht, um schnell Probeclips nahe der finalen Bildqualität für Kundenfreigaben und Vorbesprechungen zu erhalten.
- Content-Teams erstellen audio-synchronisierte Clips – Sprachaufnahmen- oder Musikreferenzen werden bereitgestellt und die Audiogenerierung aktiviert, um fertige Videos mit synchronisierten Dialogen und Soundeffekten zu erzeugen, die direkt verwendet oder weiter gemischt werden.
Grenzen und Auswahlhinweise
Ein einzelner generierter Clip ist höchstens 30 Sekunden lang; längere Erzählungen müssen in mehrere Clips aufgeteilt, separat generiert und dann zusammengefügt werden. Für Referenzmaterialien gelten klare Einschränkungen: Videos müssen 2 bis 30 Sekunden lang sein und dürfen insgesamt 30 Sekunden nicht überschreiten; auch die Gesamtaudiodauer darf 30 Sekunden nicht überschreiten; zudem gibt es Unter- und Obergrenzen für Dateigröße und Pixelzahl pro Datei; nicht konforme Materialien führen direkt zum Fehlschlag. Diese Route dient der referenzgeführten Generierung und unterstützt weder Videoschnitt noch das Verlängern des Originalvideos; Referenzen aus mehreren Materialien bedeuten zudem höheren Aufwand für Prompt-Erstellung und Parameterabstimmung. Für leichte Anforderungen mit einer einzigen Einstellung ohne Konsistenzvorgaben kann die Text-zu-Video-Route derselben Serie in Betracht gezogen werden.
Häufige Fragen
Alle Fragen ansehen →-
Müssen bei Seedance 2.5 für die Bild-zu-Video-Generierung sowohl das erste als auch das letzte Frame hochgeladen werden?
Nein. Im Modus für das erste Frame bzw. erstes und letztes Frame erweitert das Modell die nachfolgenden Bilder auf natürliche Weise, wenn nur first_frame_url hochgeladen wird. Wenn der Endzustand der Kamerafahrt gesteuert werden soll, kann zusätzlich last_frame_url angegeben werden. Das letzte Frame kann nicht allein verwendet werden. Alternativ können reference_image_urls oder reference_audio_urls als Referenzmodus verwendet werden, ohne Endpunkt-Frames zu übergeben.
-
Können das erste Frame, das erste und letzte Frame sowie mehrere Referenzmaterialien in einer einzigen Anfrage kombiniert werden?
Derzeit behandelt HiAPI Playground sie als zwei Eingabemodi: den Modus „erstes Frame/erstes und letztes Frame“ oder den Referenzmodus mit reference_image_urls und reference_audio_urls. Um Konflikte zwischen den Steuersignalen zu vermeiden, bitte pro Anfrage nur einen Modus verwenden; wenn ein Referenzvideo zur Steuerung von Bewegungen oder Kamerafahrten benötigt wird, stattdessen das separate seedance-2.5/reference-to-video verwenden.
-
Welche Dauern und Auflösungen unterstützt Seedance 2.5 bei der Bild-zu-Video-Generierung?
Der aktuelle Anfragevertrag unterstützt ganzzahlige Dauern von 4–30 Sekunden sowie 720p und 1080p. Die Ausgabe von aspect_ratio ist fest auf adaptive gesetzt und folgt dem Seitenverhältnis des ersten Frames. Die vier Beispiele auf der Seite sind alle in 720p, davon drei mit 4 Sekunden und eines mit 5 Sekunden; 30 Sekunden liegt im vom Interface unterstützten Bereich, für das derzeit kein entsprechendes Beispiel auf der Seite vorhanden ist.
-
Wie wird die Bilder-zu-Video-Funktion von Seedance 2.5 abgerechnet?
Die Abrechnung erfolgt nach Ausgabedauer und Auflösung; für 720p und 1080p gelten unterschiedliche Tarife pro Sekunde. Die konkreten Beträge richten sich nach dem Echtzeitpreis auf der Modellseite und dem Aufgabenprotokoll.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: seedance-2.5/reference-to-video
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für seedance-2.5/reference-to-video und Route default — siehe Parametertabelle unten.
promptstringPflichtGenerierungsanweisung, die erklärt, wie die Referenzmaterialien verwendet werden sollen; Referenzelemente werden der Reihe nach als @image1, @video1, @audio1 referenziert. Dieses Modell dient der referenzgesteuerten Generierung und unterstützt keine Videobearbeitung oder -fortsetzung.
durationintegerOptionalStandard: 5Dauer des Ausgabevideos in Sekunden; -1 steht für automatische Dauer, oder eine ganze Zahl zwischen 4 und 30. Standard 5.
-145678910Alle anzeigen (20)
1112131415161718192021222324252627282930resolutionstringOptionalStandard: "480p"Auflösung des Ausgabevideos; unterstützt 480p, 720p, 1080p. Standard 480p.
480p720p1080pweb_searchbooleanOptionalStandard: falseOb das Modell Echtzeitinformationen aus dem Internet suchen darf, die im Prompt erwähnt werden. Standard false.
aspect_ratiostringOptionalStandard: "adaptive"Seitenverhältnis des Ausgabebilds; adaptive bedeutet, dass das Modell dem Verhältnis des Referenzmaterials folgt. Standard adaptive.
16:94:31:13:49:1621:9adaptiveoutput_formatstringOptionalStandard: "mp4"Containerformat des Ausgabevideos; mp4 ist das Standardformat mit besserer Kompatibilität, mov richtet sich an die professionelle Postproduktion. Standard mp4.
mp4movgenerate_audiobooleanOptionalStandard: trueOb Dialog, Soundeffekte und Hintergrundaudio synchron mitgeneriert werden. Standard true.
reference_audio_urlsarrayOptionalmaxItems 10Array von Referenzaudio-URLs, maximal 10 Segmente; jedes Segment muss wav oder mp3 sein, höchstens 15 MB groß und 2 bis 30 Sekunden lang; die kumulierte Audiodauer darf 30 Sekunden nicht überschreiten. Bei Bereitstellung von Referenzaudio muss mindestens ein Referenzvideo mitgeliefert werden.
Array [ string ]
reference_image_urlsarrayOptionalmaxItems 30Array von Referenzbild-URLs, maximal 30 Bilder; unterstützt jpeg, png, webp, bmp, tiff, gif, je maximal 30 MB, jede Seite 300 bis 6000 Pixel, Seitenverhältnis 0,4 bis 2,5; SVG, HEIC und HEIF werden nicht unterstützt.
Array [ string ]
reference_video_urlsarrayPflichtminItems 1maxItems 10Array von Referenzvideo-URLs, maximal 10 Segmente; jedes Segment muss mp4 oder mov sein, die Gesamtpixelzahl darf nicht unter 409600 liegen (z. B. 854x480 oder höher), Bildrate 24 bis 60 fps, Größe höchstens 200 MB, Dauer 2 bis 30 Sekunden, jede Seite 300 bis 6000 Pixel, Seitenverhältnis 0,4 bis 2,5; die kumulierte Videodauer darf 30 Sekunden nicht überschreiten.
Array [ string ]
callbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5/reference-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"web_search": false,
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"reference_video_urls": "…"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedance-2.5/reference-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"web_search": false,
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true,
"reference_video_urls": "…"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "seedance-2.5/reference-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"web_search": False,
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": True,
"reference_video_urls": "…"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →-
Tutorial
So rufen Sie hailuo-2.3-fast/image-to-video über die HiAPI API auf: curl und Python in der Praxis
Die erste lauffähige Anfrage für die schnelle, kostengünstige Bild-zu-Video-Stufe – von der Modell-ID bis zum heruntergeladenen MP4
-
Tutorial
kandinsky-6.0-pro/image-to-video auf HiAPI: Tutorial mit curl und Python
Eine funktionierende Bild-zu-Video-Anfrage auf HiAPI ausführen: vom Upload des ersten Frames über asynchrones Polling bis zum finalen Download
-
Tutorial
So nutzt du kling-4.0/text-to-video über die HiAPI-API: curl, Python und ein lauffähiges Anforderungsbeispiel
Ein praxisnaher Leitfaden für Entwickler: filmische Prompts, synchrones Audio, asynchrones Polling und Download der Ausgabe
-
Vergleichstest
Recraft v4.1 Flash 文生图横向对比:Entwickler-Auswahl und Migrationsleitfaden
Mit Kosten von $0,01 pro Bild und reiner Text-zu-Bild-Fähigkeit beurteilen, ob es zu Ihrer Bildgenerierungs-Pipeline passt
-
Tutorial
So rufen Sie hailuo-2.3/text-to-video über die HiAPI API auf: curl, Python und lauffähige Anfragebeispiele
-
Vergleichstest
hailuo-2.3-fast/image-to-video im Quervergleich: Wie man Bild-zu-Video-Modelle auswählt und worauf bei der Migration zu achten ist
-
Tutorial
Kandinsky 6.0 Pro Text-zu-Video auf HiAPI: curl- und Python-Tutorial
Eine anfrageorientierte praktische Demonstration: Aufbau des Aufrufs vom Prompt zum Videoclip, Absenden der Anfrage, Abfragen des Fertigstellungsstatus und Herunterladen des Ergebnisses
-
Tutorial
So rufen Sie kling-4.0/image-to-video auf HiAPI auf: curl, Python und Polling
Ähnliche Modelle
Alle Modelle ansehen →Gleicher Typ
-
Kling 4.0 Kuaishou $0.330 /Sekunde -
MiniMax H3 MiniMax $0.072 /Sekunde -
Veo 3.1 Google $0.290 /Sekunde -
Kandinsky 6.0 Pro $1.93 /Video -
HeyGen Avatar IV HeyGen $0.150 /Sekunde -
HeyGen Avatar V HeyGen $0.150 /Sekunde -
Seedance 2.5 ByteDance $0.121 /Sekunde -
Hailuo 2.3 MiniMax $0.270 /Video -
FLUX 3 Video Black Forest Labs $0.090 /Sekunde -
Kling 3.0 Kuaishou $0.100 /Sekunde -
Kling AI Avatar Kuaishou -- -
Gemini Omni Google --