Zugang zu Seedance 2.5 | Key, Anfrage, erster Render
Zugang zu Seedance 2.5: die echte Version bestätigen, einen Key holen, die Felder der ersten Anfrage, Standardwerte, die Geld kosten, und die Abrechnung.
ByteDance kündigte Seedance 2.5 am 31. Juli 2026 an, und die Anbieter übernahmen es danach zu unterschiedlichen Zeitpunkten. Dieser gestaffelte Rollout ist der Grund, warum der Zugang zu Seedance 2.5 eine schwierigere Frage ist, als sie aussieht: Jede Menge Oberflächen bewerben es und liefern darunter weiterhin das ältere Modell aus. Zu einem ersten Render zu kommen heißt, die Version zu bestätigen, einen Key zu halten und eine Anfrage zu schicken, deren Standardwerte du tatsächlich gelesen hast.
Zuerst: Bestätige, dass die Version echt ist
Zwei Prüfungen klären das, und keine davon kostet etwas.
Fordere 20 Sekunden an. Seedance 2.5 läuft in einer Generierung von 4 bis 30 Sekunden. Seedance 2.0 hört bei 15 auf. Eine 20-Sekunden-Anfrage, die am Dauerfeld abgelehnt wird, heißt, du bist auf 2.0. Eine Validierungsablehnung passiert, bevor ein Task erzeugt wird, also wird nichts berechnet.
Lies den Modellbezeichner. Der veröffentlichte 2.5-Build wird unter einem String ausgeliefert, der auf -face endet, ausgeschrieben doubao-seedance-2.5-face. Vor der Veröffentlichung publizierte Codebeispiele zitieren einen Bezeichner ohne dieses Suffix, und der löst nicht mehr auf. Zeigt die Dokumentation einer Plattform immer noch den alten String, liegt ihre Integration vor der Veröffentlichung.
Eine dritte Prüfung, die nicht beweisend, aber vielsagend ist: Bietet die Oberfläche eine 4K-Stufe an, beschreibt sie Marketing von vor der Veröffentlichung. Das Modell endet bei jedem Anbieter bei 1080p, darunter liegen 720p und 480p.
Hol dir einen Key und einen Ort für Dateien
Ein API-Key aus dem Plattform-Dashboard, geschickt als Authorization: Bearer-Header, ist die gesamte Authentifizierung. Behandle ihn als Zahlungsmittel und halte ihn auf einem Server.
Wenn du Referenzmaterial nutzen willst, brauchst du außerdem einen Ort, um es zu hosten. Medieneingaben sind ausschließlich öffentliche HTTP- oder HTTPS-URLs. Data-URIs werden plattformweit abgelehnt, lokale Dateien müssen also hochgeladen werden, bevor auf sie verwiesen werden kann.
Zugang zu Seedance 2.5 mit einer ersten Anfrage
Der Call ist ein POST auf den Videogenerierungs-Endpunkt der Plattform. Er liefert eine Task-ID zurück, kein Video. Danach fragst du einen Task-Endpunkt ab, bis der Status endgültig ist. Pollen ist kostenlos.
Der kleinste sinnvolle Body ist ein Modell-String, ein Prompt und eine Dauer. Die Standardwerte darunter zählen mehr, als die meisten erwarten:
| Feld | Standard | Wissenswert |
|---|---|---|
| Dauer | 5 Sekunden | Bereich ist 4 bis 30. Mit -1 wählt das Modell selbst und reserviert an der 30-Sekunden-Obergrenze |
| Auflösung | 720p | 480p und 1080p sind die beiden anderen Optionen |
| Seitenverhältnis | adaptive | Feste Verhältnisse gibt es, wenn die Ausgabe einen Zielrahmen hat |
| Audio | an | Sprache, Effekte und Musik werden zusammen mit dem Bild erzeugt |
Die Standarddauer von 5 Sekunden ist ein sinnvoller erster Render. Den Wert -1 solltest du am Anfang vermeiden, weil die Reservierung an der Obergrenze genommen wird und nicht an dem, was das Modell am Ende produziert.
Prompts gehen bis 20000 Zeichen. Ein Prompt ist für Text-zu-Video erforderlich und wird optional, sobald Referenzmedien angehängt sind.
Die Tür zu den Referenzmedien
Das ist die Fähigkeit, die 2.5 von der älteren Version trennt, und sie ist schon bei der ersten Anfrage erreichbar. Ein Job akzeptiert bis zu 30 Referenzbilder, 10 Referenzvideo-Clips und 10 Audiospuren.
Die Preisasymmetrie ist das, was du verinnerlichen solltest. Referenzbilder und Referenzaudio fügen der Rechnung nichts hinzu. Referenzvideo schon, und zwar doppelt. Ein Quellclip wird zusätzlich zur Ausgabe mit seiner eigenen Länge berechnet, und jede Anfrage, die Video enthält, trägt eine Abrechnungsuntergrenze von fünf Dritteln der Ausgabedauer. Ein zwei Sekunden langes Quellvideo mit fünf Sekunden Ausgabe rechnet neun statt sieben Sekunden ab. Jeder Referenzclip läuft 2 bis 30 Sekunden, und das Referenzvideo insgesamt darf 30 Sekunden nicht überschreiten.
Ein erster Render, der auf Standbildern beruht, ist also nahezu frei von Überraschungen. Ein erster Render, der auf Filmmaterial beruht, ist es nicht und sollte klein ausfallen.
Was der erste Clip kostet
Die Preise gelten pro Sekunde fertigem Video, festgelegt durch die Auflösung und dadurch, ob die Anfrage einen Referenzclip trug:
| Auflösung | Nur Generierung | Mit Referenzvideo |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
Ein fünf Sekunden langer 480p-Clip kostet rund $0.59. Ein zehn Sekunden langer 1080p-Clip kostet rund $4.62. Der Abstand zwischen diesen beiden Zahlen ist das Argument dafür, den ersten Versuch kurz und klein zu halten, zu bestätigen, dass der Prompt tut, was du meintest, und erst danach Auflösung und Länge hochzuziehen.
Die Generierung dauert zwei bis fünf Minuten. Fehlgeschlagene Jobs werden vollständig erstattet, Ablehnungen eingeschlossen.
Wenn der erste Call scheitert
Eine Sicherheitsablehnung liefert Fehler 80006. Der Fehler nennt nicht, welche Stufe ausgelöst hat, also kommen der Prompt, jedes Referenzbild und die generierte Ausgabe alle infrage, und die Diagnose ist Handarbeit: auf einen neutralen Prompt reduzieren, bestätigen, dass er durchgeht, und die Elemente einzeln wieder hinzufügen.
Der Parameter content_filter steht standardmäßig auf true. Ihn auf false zu setzen leitet die Anfrage auf einen weniger restriktiven Kanal und schaltet die Moderation nicht ab. Darunter liegen Sperren auf Modellebene für namentlich genannte reale Prominente, fremdes geistiges Eigentum und illegale Inhalte, die keine Anbietereinstellung entfernt.
Alles andere auf der Liste der Fehlschläge beim ersten Call ist Validierung: eine Dauer außerhalb von 4 bis 30, ein ausgemusterter Modell-String, eine data:-URL, ein Referenzclip über der Längengrenze. Keines davon erzeugt einen Task, also kostet keines davon etwas.
Häufige Fragen
Brauche ich ein anderes Konto für Seedance 2.5 statt 2.0? Nein. Plattformen, die beide anbieten, legen sie als getrennte Modellbezeichner auf einem Konto und einem Key offen. Der Wechsel zwischen den Versionen ist meist eine Änderung an einem String.
Woran erkenne ich, dass eine Plattform wirklich 2.5 betreibt?
Fordere 20 Sekunden an. Erfolg heißt 2.5, eine Ablehnung am Dauerfeld heißt 2.0. Prüfe dann, ob der Modellbezeichner auf -face endet.
Komme ich ohne API-Key an Seedance 2.5? Consumer-Apps und gebündelte Editor-Integrationen erreichen das Modell ohne einen, auf Kosten von Parameterzugriff und Abrechnung pro Sekunde. Du bekommst stattdessen Presets und ein Credit-Guthaben.
Gibt es 4K in irgendeinem Tarif? Nein. Das veröffentlichte Modell endet bei 1080p. Die 4K-Zahl stammt aus Berichterstattung vor der Veröffentlichung, die nie eingelöst wurde.
Kurz gesagt
Zugang zu Seedance 2.5 sind vier Schritte. Überprüfe die Version mit einer 20-Sekunden-Anfrage und dem -face-Bezeichner. Hol dir einen Key und halte ihn serverseitig. Schick einen kurzen ersten Job, fünf Sekunden in 480p, und lass die Standardwerte außer Dauer und Auflösung in Ruhe. Polle zwei bis fünf Minuten und lade das Ergebnis herunter. Referenzbilder und Audio anzuhängen ist kostenlos, Referenzvideo wird mit seiner eigenen Länge und einer Untergrenze von fünf Dritteln abgerechnet, und alles, was scheitert, wird erstattet.
