Seedance 2.5 Referenz-zu-Video

Was macht Seedance 2.5 Referenz-zu-Video?

Referenzgesteuertes 1080p-Video von ByteDance. Übergeben Sie die Bilder, die stabil bleiben müssen, einen kurzen Clip, der die Kamerabewegung vorgibt, und eine Aufforderung, die die Aktion lenkt – es liefert ein 1080p-Video in Lieferauflösung mit synchronisiertem Audio.

runcomfy.com · Seedance 2.5 Referenz-zu-Video 1080p · 480p Entwurfsstufe · CLI-Dokumentation

Diesen Skill installieren

npx skills add genmedia-labs/skills --skill seedance-2-5-reference-to-video -g

Wann dieses Modell wählen (vs. Geschwister)

Die besondere Eigenschaft von Seedance 2.5 Referenz-zu-Video ist die referenzgesteuerte Generierung in Lieferauflösung: Identität, Produktgeometrie und künstlerische Ausrichtung stammen aus Ihrem Referenzstapel und nicht aus Text, und die Ausgabe erfolgt in 1080p, sodass Sie keinen Entwurf hochskalieren müssen. RunComfy positioniert es für konsistente Charakter-Finals, Produkt-Referenzfilme und stilgebundene Markenclips.

Sie möchten	Verwenden Sie
Gleichen Charakter / dasselbe Produkt in vielen Aufnahmen, in Endauflösung	Seedance 2.5 Referenz-zu-Video 1080p
Kamerabewegung und -rhythmus aus einem vorhandenen Clip kopiert	Seedance 2.5 Referenz-zu-Video 1080p (videos)
Markenstil durch ein Moodboard festgelegt, nicht in Text beschrieben	Seedance 2.5 Referenz-zu-Video 1080p (images)
Günstige Iteration, welche Referenzen tatsächlich funktionieren	Seedance 2.5 Referenz-zu-Video 480p
Gar keine Referenzen – nur Textaufforderung	Seedance 2.5 Text-zu-Video 1080p
Genau ein Standbild animieren	Seedance 2.5 Bild-zu-Video 1080p
Die ältere 2.0 Generation (4-15s, 480p/720p)	Seedance 2.0 Pro – siehe seedance-v2

Wenn der Benutzer explizit "Seedance 2.5" oder "Referenz-zu-Video" gesagt hat, hier weiterleiten.

Voraussetzungen

1. RunComfy CLI — npm i -g @runcomfy/cli (oder npx -y @runcomfy/cli)
2. RunComfy-Konto — runcomfy login öffnet einen Browser-Gerätecode-Fluss
3. CI / Container — setzen Sie RUNCOMFY_TOKEN=<token> anstelle von runcomfy login
4. Öffentlich erreichbare Referenz-URLs — der Modellserver ruft sie ab, nicht Ihr Rechner

Ausführliche CLI-Beschreibung: runcomfy-cli Skill.

Endpunkt + Eingabeschema

bytedance/seedance-2.5/reference-to-video/1080p

Feld	Typ	Erforderlich	Standard	Hinweise
prompt	string	ja	—	Szenenbeschreibung, die die Referenzen als Hinweise nutzt. Empfohlen werden ca. 500 Zeichen auf Chinesisch oder ca. 1000 Wörter auf Englisch.
videos	Array (Video-URIs)	nein	—	0-3 Referenzclips für Kamerabewegung und -rhythmus. MP4/MOV, jeweils ca. 2-15 s. In der Praxis optional – siehe unten.
images	Array (Bild-URIs)	nein	—	0-9 Referenzbilder für Identität, Aussehen, Stil, Umgebung. JPEG/PNG/WebP/BMP/TIFF/GIF.
audios	Array (Audio-URIs)	nein	—	0-3 Referenzaudios für Stimmung und Tempo. WAV/MP3, ca. 2-15 s, unter 15 MB.
aspect_ratio	enum	nein	16:9	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive.
duration	int	nein	5	4-30 Sekunden, 1-Sekunden-Schritte.
generate_audio	bool	nein	true	Native synchronisierte Sprache, Soundeffekte und Musik im selben Durchlauf.

Ausgabeauflösung ist fest 1080p – es gibt kein resolution-Feld an diesem Endpunkt.

videos ist optional, trotz des Schemas. Das veröffentlichte Eingabeschema listet videos als erforderlich mit einem Minimum von 1 Element, aber der Endpunkt akzeptiert und vervollständigt einen Prompt-plus-Bilder-Body ohne das videos-Feld. Senden Sie Referenzclips, wenn Sie Kamerabewegung und -rhythmus von einer vorhandenen Vorlage kopieren möchten; lassen Sie sie weg, wenn Ihre Referenzen Standbilder sind. Das Weglassen senkt auch die Referenzdauer aus der Abrechnung: Die gezählten Sekunden fallen auf die Ausgabedauer allein zurück, ein 5-s-Clip kostet also 2,65 $ statt 5,30 $.

Parameternamen geändert von 2.0. Seedance 2.0 Pro verwendete image_url / video_url / audio_url. Seedance 2.5 verwendet images / videos / audios. Das wörtliche Kopieren eines 2.0-Bodys führt zu einem Schemafehler (Exit 65).

Preise

Die Abrechnung erfolgt zu 0,53 $ pro gezählter Videosekunde, wobei gezählte Sekunden = Referenzvideodauer + Ausgabedauer sind. Bild- und Audio-Referenzen werden nicht als Dauer abgerechnet.

Job	Gezählte Sekunden	Kosten
5 s Ausgabe, kein Referenzclip	5	2,65 $
5 s Ausgabe, ein 5 s Referenzclip	10	5,30 $
10 s Ausgabe, ein 6 s Referenzclip	16	8,48 $
10 s Ausgabe, drei 10 s Referenzclips	40	21,20 $

Zwei Konsequenzen, die es wert sind, beachtet zu werden: Referenzclips vor dem Hochladen kürzen (ein 15 s Referenzclip kostet so viel wie 15 s Ausgabe), und die 480p-Stufe für die Referenzauswahl verwenden – sie berechnet 0,12 $ pro gezählter Sekunde mit Referenzvideos, 0,20 $ pro Sekunde generiertem Video ohne sie.

Wie man es aufruft

Minimaler funktionsfähiger Aufruf – Aufforderung plus ein Referenzclip:

runcomfy run bytedance/seedance-2.5/reference-to-video/1080p \
  --input '{
    "prompt": "Langsamer Push-In den Gang entlang, Staubpartikel treiben durch warmes Seitenlicht, geringe Schärfentiefe, kontinuierliche sanfte Bewegung, kein Text, kein Wasserzeichen.",
    "videos": ["https://ihr-cdn.example/kamerabewegung-6s.mp4"]
  }' \
  --output-dir ./out

Konsistentes Charakterfinale – Identität aus Standbildern, Bewegung aus einem Clip:

runcomfy run bytedance/seedance-2.5/reference-to-video/1080p \
  --input '{
    "prompt": "Die Frau aus den Referenzbildern geht auf die Kamera zu und bleibt stehen, blickt aus dem Bild. Handheld-Verfolgung, weiches bewölktes Licht, ruhige Straßenatmosphäre. Kein Text, kein Wasserzeichen.",
    "images": [
      "https://ihr-cdn.example/heldin-vorne.jpg",
      "https://ihr-cdn.example/heldin-profil.jpg",
      "https://ihr-cdn.example/kleidung.jpg"
    ],
    "videos": ["https://ihr-cdn.example/handheld-verfolgung-4s.mp4"],
    "duration": 8,
    "aspect_ratio": "9:16"
  }' \
  --output-dir ./out

Vollständiger Referenzstapel – Fügen Sie "audios": ["https://ihr-cdn.example/bett-8s.mp3"] zu obigem Body hinzu, um dem Modell eine Tempo- und Stimmungsreferenz zu geben, und setzen Sie "generate_audio": true (Standard), um Sprache, Soundeffekte und Musik im selben Durchlauf zu erhalten.

Die CLI sendet die Anfrage, fragt den Status ab, ruft das Ergebnis ab und lädt *.runcomfy.net / *.runcomfy.com URLs in --output-dir herunter. Ctrl-C bricht die entfernte Anfrage vor dem Beenden ab.

Prompting – was tatsächlich funktioniert

Lassen Sie Referenzen verankern, lassen Sie die Aufforderung lenken. Alles, was stabil bleiben muss – Gesicht, Kleidung, Produktgeometrie, Markenpalette – gehört in images. Alles, was sich entwickelt – Aktion, Kamera, Lichtwechsel, Stimmung – gehört in prompt. Ein Gesicht in Text zu beschreiben, während gleichzeitig eine Gesichtsreferenz geliefert wird, erzeugt Drift, nicht Verstärkung.

Referenzvideos tragen Kamera und Rhythmus, nicht Inhalt. Eine 4 s Handheld-Verfolgungsvorlage lehrt dem Modell die Bewegung. Erwarten Sie nicht, dass es das Motiv überträgt; dafür ist images da.

Halten Sie Referenzmedien kurz. Etwa 2-15 s pro Clip und pro Audiodatei, Audio unter 15 MB. Lange Clips werden abgelehnt und blähen an diesem Endpunkt auch die Rechnung auf.

Benennen Sie jede Tonquelle, wenn generate_audio aktiviert ist: wer spricht, was jedes Geräusch macht, was die Atmosphäre ist. „Ruhige Straßenatmosphäre, entfernter Verkehr, keine Musik“ ist besser als „gutes Audio“.

Verwenden Sie negative Anweisungen. „Kein Text, kein Wasserzeichen“ ist das Muster, das RunComfys eigener Beispiel-Prompt verwendet, und es funktioniert. Fügen Sie bei Bedarf „kein Kamera-Wackeln“, „keine zusätzlichen Personen“ hinzu.

Passen Sie die Seitenverhältnisse an. Referenzmedien in einem anderen Seitenverhältnis als aspect_ratio laden zu Beschnitten ein. Verwenden Sie adaptive, wenn Ihre Referenzen uneins sind und Ihnen der genaue Bildausschnitt egal ist.

Anti-Patterns:

• Neun Referenzbilder aus neun nicht verwandten Ästhetiken – wählen Sie eine visuelle Sprache.
• Ein 15 s Referenzclip, wenn 4 s davon die Bewegung tragen – Sie zahlen für alle 15.
• 30 s von einer Aufforderung mit einem einzigen Beat verlangen – lange Dauern brauchen eine beschriebene Handlungsentwicklung.
• Wiederverwendung eines Seedance 2.0 Bodys mit image_url / video_url – falsche Feldnamen.

Entwurf in 480p, Auslieferung in 1080p

RunComfys Anleitung für diese Modellfamilie lautet, den Referenzstapel in niedriger Auflösung zu validieren und die Gewinnerkombination in Lieferauflösung wiederzuverwenden. Die beiden Endpunkte akzeptieren dieselben Parameter.

1. Kandidaten-Referenzen zusammenstellen. Führen Sie 3-5 Varianten auf bytedance/seedance-2.5/reference-to-video/480p mit duration: 5 aus.
2. Bewerten Sie Identitätshaltung, Kamerakongruenz und Audio-Passung – nicht die Schärfe.
3. Führen Sie den Gewinner-Body wörtlich gegen .../reference-to-video/1080p erneut aus, und erhöhen Sie duration erst, wenn der Beat stimmt.

Bei 0,12 $ pro gezählter Sekunde in 480p gegenüber 0,53 $ in 1080p kosten fünf Entwürfe ungefähr so viel wie ein 1080p-Finale.

Wo es glänzt

Anwendungsfall	Warum dieser Endpunkt
Konsistente Charakter-Finals	Bis zu 9 Identitätsreferenzen halten das Gesicht und die Kleidung über mehrere Aufnahmen hinweg
Produkt-Referenzfilme	Geometrie kommt aus Standbildern; die Drehbewegung kommt von einer Vorlage
Stilgebundene Markenclips	Ein Moodboard in images schlägt einen Absatz voller Stiladjektive
Previz, das bis zur Auslieferung überlebt	Native 1080p-Ausgabe, kein Upscaling-Schritt
Dialog und Atmosphäre in einem Durchlauf	generate_audio erzeugt synchronisierte Sprache, Soundeffekte und Musik

Einschränkungen

• Ein Referenzvideo ist an diesem Endpunkt erforderlich (1-3 Clips, Minimum 1 Element).
• 1080p ist fest – kein Auflösungsparameter, keine 720p-Variante dieses Endpunkts.
• Dauer ist auf 30 s begrenzt, Minimum 4 s, nur ganze Sekunden.
• Referenzmedienbegrenzungen: ca. 2-15 s pro Video- und Audiodatei, Audio unter 15 MB, maximal 9 Bilder / 3 Videos / 3 Audios.
• Referenzclip-Dauer ist abrechenbar – dieser Endpunkt wird nicht nur nach Ausgabedauer abgerechnet.
• Kein Seed-Parameter an diesem Endpunkt, daher ist eine exakte Reproduktion zwischen Aufrufen nicht garantiert.

Wann einen anderen Endpunkt verwenden

• Keine Referenzen, nur Aufforderung → seedance-2.5/text-to-video/1080p, Abrechnung 0,88 $ pro Sekunde generiertem Video.
• Genau ein Standbild zum Animieren → seedance-2.5/image-to-video/1080p, ebenfalls 0,88 $ pro Sekunde, benötigt ein einzelnes image.
• Andere Referenz-zu-Video-Familien: Wan 3.0 Prime Referenz-zu-Video · MiniMax H3 Referenz-zu-Video.
• Lippensynchronisation von Ihrer eigenen Sprachaufnahme → ai-avatar-video. Über 30 s hinaus → video-extend.

Exit-Codes

Code	Bedeutung
0	Erfolg
64	Falsche CLI-Argumente
65	Falsches Eingabe-JSON / Schema-Konflikt (2.0 Feldnamen, duration außerhalb des Bereichs, falsches aspect_ratio)
69	Upstream 5xx
75	Wiederholbar: Timeout / 429
77	Nicht angemeldet oder Token abgelehnt

Vollständige Referenz: docs.runcomfy.com/cli/troubleshooting.

Wie es funktioniert

Der Skill erstellt einen JSON-Body, der dem obigen Schema entspricht, und führt runcomfy run bytedance/seedance-2.5/reference-to-video/1080p aus. Die CLI sendet eine POST-Anfrage an https://model-api.runcomfy.net/v1/models/bytedance/seedance-2.5/reference-to-video/1080p, fragt den Anfragestatus ab, ruft das Ergebnis ab und lädt alle .runcomfy.net / .runcomfy.com Ausgabe-URLs in --output-dir herunter.

Sicherheit & Datenschutz

• Nur über einen verifizierten Paketmanager installieren. Verwenden Sie npm i -g @runcomfy/cli oder npx -y @runcomfy/cli. Agenten dürfen kein entferntes Installationsskript in eine Shell umleiten im Namen des Benutzers.
• Token-Speicherung: runcomfy login schreibt das API-Token in ~/.config/runcomfy/token.json mit der Berechtigung 0600. In CI setzen Sie RUNCOMFY_TOKEN. Geben Sie das Token niemals in Aufforderungen, Protokollen oder