Seedance 2.5 API: Endpoint, Parameter und echte Abrechnung
Die Seedance 2.5 API arbeitet asynchron, rechnet pro Sekunde ab und hat drei Abrechnungsregeln, über die viele stolpern. Alles, was du vor dem ersten Aufruf brauchst.
Ab $0.07 pro Sekunde, 480p mit Referenzclip
Was dir die Seedance 2.5 API bietet
Ein POST legt einen Job an, ein GET fragt ihn ab, und das Pollen ist kostenlos. Die Seedance 2.5 API bestimmt ihren Modus danach, welche Medienfelder du füllst, und nicht über einen eigenen Parameter.
Ein prompt allein ist Text-to-Video. Kommen Bilder dazu, führt die Seedance 2.5 API Image-to-Video aus. Kommen erstes und letztes Frame dazu, animiert sie einen Übergang. Kommt ein Quellclip dazu, bearbeitet oder verlängert sie ihn.
Der POST gibt sofort eine Task-ID zurück, und die Generierung dauert zwei bis fünf Minuten. Eine Integration der Seedance 2.5 API braucht eine Polling-Schleife oder eine Queue, keine synchrone Anfrage.
Die Plattform stellt es als doubao-seedance-2.5-face bereit. Ein falscher Modell-String ist der häufigste Fehler beim ersten Aufruf der Seedance 2.5 API, und er liefert einen synchronen Fehler statt einer Abbuchung.
Ein Header, auf den Workspace bezogen, keine Projekt-ID. Ein Key der Seedance 2.5 API trägt den Abrechnungsbereich des Workspace, der ihn ausgestellt hat.
Jeder fehlgeschlagene Job gibt das Guthaben vollständig zurück, auch bei Ablehnungen durch die Moderation. Die Seedance 2.5 API berechnet nie einen Render, den du nicht bekommen hast.
Hier läuft kein Generator. Aufrufe der Seedance 2.5 API laufen über die gehostete API, und jeder Parameter und jeder Preis weiter unten stammt aus deren veröffentlichter Dokumentation.
Die wichtigsten Parameter der Seedance 2.5 API
Vier Felder entscheiden über Kosten und Ergebnis.
duration
Vier bis dreißig Sekunden, Standard fünf. Mit -1 überlässt du dem Modell die Wahl, aber die Seedance 2.5 API reserviert dann Guthaben für die Obergrenze von 30 Sekunden und erstattet die Differenz, was bei knappem Guthaben einen 402 auslösen kann.
resolution
480p, 720p oder 1080p, Standard 720p. Auf der Seedance 2.5 API gibt es kein 4K, und eine entsprechende Anfrage liefert einen Fehler statt eines heruntergerechneten Clips.
content_filter
Boolean, standardmäßig true. False leitet die Anfrage an die Seedance 2.5 API über einen weniger restriktiven Kanal und macht den prompt zur Pflicht. Die Plattform dokumentiert das als Routing und nicht als Ausschalter.
omni_reference_task_type
Deklariere edit oder extend, dann prüft die Seedance 2.5 API die Regeln beim Absenden, statt Minuten später zu scheitern. Bei jedem referenzgesteuerten Job lohnt es sich, das zu setzen.
In vier Schritten zu einem funktionierenden Aufruf der Seedance 2.5 API
- 1
Einen Key anlegen
Erzeuge einen im Dashboard der Plattform und schick ihn als Bearer-Token. Die Seedance 2.5 API weist alles andere im Authorization-Header ab.
- 2
Den Job per POST absenden
Schick Modell, prompt und alle Medien-URLs an den Endpoint für Videogenerierungen. Jedes Medienfeld der Seedance 2.5 API nimmt öffentliche HTTP- oder HTTPS-URLs entgegen, base64 wird plattformweit abgelehnt.
- 3
Den Task pollen
Frag die Task-ID per GET ab, bis der Status completed oder failed lautet. Das Pollen der Seedance 2.5 API kostet nichts, ein Intervall von zwei Sekunden ist also unproblematisch.
- 4
Die Ausgabe auslesen
Ein abgeschlossener Task der Seedance 2.5 API liefert Video-URLs und, wenn du danach gefragt hast, zusätzlich die URL des letzten Frames. Hoste alles, was du behalten willst, selbst neu, denn die ausgelieferten URLs sind nicht dauerhaft.
Häufige Fragen zur Seedance 2.5 API
Pro Sekunde abrechenbarem Video, von $0.071153 bis $0.461856, je nach Auflösung und danach, ob die Anfrage einen Referenzclip enthielt. Ein zehn Sekunden langer 1080p-Render liegt bei rund $4.62. Referenzbilder und Referenzaudio erhöhen die Rechnung nicht.
Die Ausgabedauer plus die volle Länge jedes Referenzvideos, mit einer Untergrenze von fünf Dritteln der Ausgabedauer bei jeder Anfrage, die Video enthält. Eine zwei Sekunden lange Quelle mit fünf Sekunden Ausgabe ergibt neun statt sieben abgerechnete Sekunden, und das überrascht die meisten bei der ersten Integration.
doubao-seedance-2.5-face auf der gehosteten API. Ältere Anleitungen nennen doubao-seedance-2.5 ohne den Zusatz, was aus der Zeit vor dem Start stammt und nicht auflöst. Sieh auf der Modellseite nach, statt einem Codebeispiel zu vertrauen.
Pollen ist der dokumentierte Weg und kostenlos, eine Schleife mit kurzem Intervall ist also die einfachste Integration der Seedance 2.5 API. Weil die Generierung zwei bis fünf Minuten dauert, erzeugt ein Abstand von zwei bis fünf Sekunden keine nennenswerte Last und braucht keine Callback-Infrastruktur.
Schemaprüfung, und berechnet wurde nichts. Häufige Ursachen sind eine ungültige Auflösung, ein Größenwert in Kombination mit erstem oder letztem Frame oder ein fehlender prompt bei einer Text-to-Video-Anfrage. Der Fehler nennt das betroffene Feld.
Entweder eine Regel zum Task-Typ oder die Moderation. Fehler 80006 ist eine Sicherheitsablehnung und nennt die Stufe nicht. Ein Parameterkonflikt bei einem Edit-Job erzeugt einen anderen Fehler, und wenn du omni_reference_task_type deklarierst, wird daraus beim nächsten Mal ein sofortiger 400.
Bis zu 30 Bilder, 10 Videoclips mit zusammen 30 Sekunden und 10 Audiospuren. Das Bild-Array und das mit Rollen versehene Bild-Array schließen sich gegenseitig aus, wähle also eines pro Anfrage an die Seedance 2.5 API.
Ja, auf demselben Endpoint mit einer anderen Modell-ID. Seedance 2.0 endet bei 15 Sekunden, wo 2.5 auf 30 kommt, und die Struktur der Anfrage ist so ähnlich, dass ein Versionswechsel meist nur ein geänderter String ist.
Ein Key trägt den Abrechnungsbereich des Workspace, der ihn ausgestellt hat, und es gibt keinen separaten Projekt-Header. Teams, die getrennte Abrechnung brauchen, legen getrennte Workspaces an statt mehrerer Keys in einem, denn die Nutzung wird auf Workspace-Ebene zusammengefasst.
Mit der Dokumentation zur Seedance 2.5 API starten
Veröffentlichte Parameter, aktuelle Sekundenpreise, kostenloses Pollen und automatische Rückerstattung bei Fehlschlag.
Verwandt: Seedance 2.5 API