Seedance 2.5 nutzen | Felder, Limits und Abrechnung

Seedance 2.5 über die gehostete API nutzen: alle Felder der Anfrage und ihre Limits, Regeln für Referenzmedien, Polling, Sekunden und Fehler 80006.
Zu wissen, wie man Seedance 2.5 nutzt, heißt vor allem, die Form der Anfrage zu kennen. Ein Call trägt einen Prompt, vier Ausgabeeinstellungen und bis zu drei Arten von Referenzmedien; die Plattform gibt eine Task-ID zurück; das fertige Video holst du per Polling ab. Die Mechanik, die sich von der älteren Version unterscheidet, sind die 30-Sekunden-Obergrenze, die Größe des Referenzbudgets und eine Abrechnungsregel, die Referenzvideo teurer macht, als die Preistabelle nahelegt.
Bestätige vor allem anderen, dass du auf 2.5 bist
Mehrere Anbieter behielten Seedance 2.0 als Standard, als sie 2.5 daneben aufnahmen, der Modell-String entscheidet also, was du bekommst. Der ausgelieferte 2.5-Build läuft unter einem Bezeichner, der auf -face endet. Ältere Codebeispiele zitieren einen Bezeichner ohne dieses Suffix, der nicht mehr auflöst.
Eine zweite Prüfung braucht keinen Code-Review. Reiche eine Anfrage für eine 20-Sekunden-Generierung ein. Auf 2.0 wird sie am Dauerfeld abgelehnt, bevor ein Task existiert, also wird nichts berechnet.
Seedance 2.5 über die gehostete API nutzen
Eine Generierungsanfrage nimmt diese Felder.
| Feld | Bereich | Standard |
|---|---|---|
prompt | bis zu 20,000 Zeichen | keiner |
duration | 4 bis 30 Sekunden, oder -1 | 5 |
resolution | 480p, 720p, 1080p | 720p |
aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive | adaptive |
generate_audio | true oder false | true |
content_filter | true oder false | true |
Der Prompt ist für Text-zu-Video erforderlich und optional, sobald Referenzmedien vorhanden sind. In Anführungszeichen gesetzte Zeilen darin werden als Sprache generiert, im selben Durchgang wie das Bild, als Monospur, die Dialog, Effekte und Musik abdeckt.
duration auf -1 zu setzen übergibt die Entscheidung über die Länge dem Modell. Die Reservierung wird an der 30-Sekunden-Obergrenze genommen, kalkuliere also mit einem Clip in voller Länge, wenn du das nutzt.
Darüber hinaus legt die Anfrage output_format für mp4 oder mov offen, dazu bitrate_mode, watermark, return_last_frame, seed, image_with_roles, omni_reference_task_type und ein tools-Array. return_last_frame ist das Feld, auf das es beim Verketten ankommt, denn das letzte Bild einer Generierung ist der Startpunkt der nächsten.
Regeln für Referenzmedien, die eine Anfrage ablehnen
Die Validierung von Referenzmedien ist streng und greift, bevor ein Task erzeugt wird, was eine Ablehnung kostenlos macht, aber auch leicht wiederholbar.
- Bilder: bis zu 30 pro Anfrage, jpeg, png, webp, bmp, tiff, gif, heic oder heif, jeweils unter 30 MB.
- Video: bis zu 10 Clips, mp4 oder mov, jeweils 200 MB oder weniger, jeweils 2 bis 30 Sekunden, 30 Sekunden zusammen.
- Audio: bis zu 10 Spuren, wav oder mp3, jeweils 15 MB oder weniger, jeweils 2 bis 30 Sekunden, 30 Sekunden zusammen.
Jede davon ist eine öffentliche HTTP(S)-URL. Data-URIs werden plattformweit abgelehnt, hoste die Datei also zuerst.
Referenzbilder und Referenzaudio fügen der Rechnung nichts hinzu. Referenzvideo schon, auf zwei Arten, und darum geht es im nächsten Abschnitt.
Die Rechnung ausrechnen, bevor du sie abschickst
Abgerechnet wird pro Sekunde fertigem Video zu einem Preis, der von der Auflösung abhängt und davon, ob Referenzvideo angehängt war.
| Auflösung | Nur Generierung | Mit Referenzvideo |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
Die abgerechneten Sekunden sind der größere von zwei Werten: die aufgerundete Länge des Referenzvideos plus die Ausgabedauer, oder fünf Drittel der Ausgabedauer, aufgerundet.
Zwei durchgerechnete Beispiele zeigen, warum das zählt.
Eine zehn Sekunden lange 1080p-Generierung ohne Referenzclip rechnet zehn Sekunden zu $0.461856 ab, also rund $4.62.
Dieselbe zehn Sekunden lange 1080p-Ausgabe mit einem sechs Sekunden langen Referenzclip rechnet den größeren Wert aus 16 Sekunden und 17 Sekunden ab, also 17 Sekunden zu $0.275904, was rund $4.69 ergibt. Der niedrigere Preis wird von der Untergrenze aufgezehrt.
Ein kleinerer Job zeigt den Effekt schärfer. Eine fünf Sekunden lange 720p-Ausgabe mit einem drei Sekunden langen Referenzclip rechnet neun statt acht Sekunden ab, was auf rund $1.44 kommt, während dieselben fünf Sekunden von Grund auf generiert knapp über $1.33 liegen.
Pollen, Timing und Erstattungen
Der Job ist asynchron. Das Einreichen liefert eine Task-ID zurück, und das Video wird abgeholt, indem du diesen Task abfragst, bis er Fertigstellung meldet.
Die Generierung dauert im Schnitt zwei bis fünf Minuten. Pollen ist kostenlos, ein festes Intervall von fünfzehn bis zwanzig Sekunden ist also vernünftig, und es bringt nichts, die Abfragen stark zu strecken.
Fehlgeschlagene Jobs werden vollständig erstattet. An den Nutzungszahlen eines fehlgeschlagenen Tasks siehst du, ob der reservierte Betrag zurückkam, was sich zu prüfen lohnt, wenn ein Batch danebengegangen ist.
Eine Ablehnung lesen
Sicherheitsablehnungen liefern Fehler 80006. Der Fehler nennt nicht, welche Stufe ausgelöst hat, die Ursache kann also der Prompt, eine Referenzdatei oder die generierte Ausgabe sein.
Fang beim Prompt an. Namentlich genannte reale Prominente, fremdes geistiges Eigentum und illegale Inhalte sind im Modell gesperrt, und keine Anbietereinstellung entfernt sie. Prüfe dann die Referenzbilder, denn ein Gesicht oder ein Logo auf einem mitgelieferten Foto kann dasselbe Ergebnis auslösen wie die Nennung im Text.
content_filter steht standardmäßig auf true. Ihn auf false zu setzen leitet die Anfrage über einen weniger restriktiven Kanal und schaltet die Moderation nicht ab. Es ist eine Routing-Steuerung und kein Schalter, und der ältere Alias nsfw_checker validiert weiterhin.
Häufige Fragen
Welchen Modell-String rufe ich für Seedance 2.5 auf?
Der ausgelieferte Build trägt einen Bezeichner, der auf -face endet. Bezeichner ohne dieses Suffix stammen aus Beispielen von vor der Veröffentlichung und lösen nicht mehr auf.
Wie generiere ich einen Clip, der länger als 30 Sekunden ist?
Du verkettest Generierungen. Dreißig Sekunden sind die Obergrenze pro Anfrage, längere Stücke sind also getrennte Jobs, die in einem Schnittprogramm zusammengefügt werden, wobei return_last_frame dir einen sauberen Übergabepunkt gibt.
Warum kostete ein Referenzvideo mehr, als die Preistabelle nahelegte? Der Referenzclip wird zusätzlich zur Ausgabe mit seiner eigenen Länge abgerechnet, und die Anfrage wird nie mit weniger als fünf Dritteln der Ausgabedauer abgerechnet, aufgerundet. Der größere der beiden Werte wird zu den abgerechneten Sekunden.
Lässt das Abschalten des Content-Filters alles durch?
Nein. content_filter auf false zu setzen wählt einen weniger restriktiven Kanal, und die Moderation gilt weiterhin. Die Sperren auf Modellebene für reale Prominente, fremdes IP und illegale Inhalte bleiben unabhängig davon bestehen.
Kurz gesagt
Seedance 2.5 nutzen, der Reihe nach: den -face-Modell-String prüfen, die Dauer zwischen 4 und 30 Sekunden setzen, Auflösung und Seitenverhältnis wählen, Audio anlassen, sofern du keine Stille willst, Referenzbilder großzügig anhängen, weil sie kostenlos sind, abschicken und dann alle fünfzehn Sekunden zwei bis fünf Minuten lang pollen. Bepreise den Job über die abgerechneten Sekunden statt über die Ausgabesekunden, sobald Referenzvideo im Spiel ist, und behandle Fehler 80006 als Erstattung plus Neuschreiben.


