Seedance 2.5 API Quickstart: Generieren Sie Ihr erstes Video mit Atlas Cloud

Sie haben die Ankündigung zu Seedance 2.5 gelesen, eine Produktfunktion für 30-sekündige generierte Clips skizziert und möchten nun Code schreiben. Dann stoßen Sie auf die Wand, die jeder Entwickler bei einem frisch angekündigten Modell trifft: Die Funktionsseite ist live, aber der Endpunkt, den Sie tatsächlich von Ihrer App aus aufrufen können, ist eine ganz andere Frage.

Hier ist die ehrliche Version der Situation und ein Quickstart, der dies berücksichtigt. Atlas Cloud hat eine Seedance 2.5 Familienseite veröffentlicht, die einen Day-0-Zugang über dieselben vereinheitlichten Endpunkte zusichert, die bereits Seedance 2.0 und 1.5 bedienen. Zum Zeitpunkt des Schreibens ist diese Auflistung als „Coming Soon“ gekennzeichnet und es wurde noch kein Atlas Cloud Preis für Seedance 2.5 veröffentlicht. Was das praktisch bedeutet, ist eine gute Nachricht: Die Integration, die Sie heute gegen eine Live-Seedance-Stufe erstellen, ist dieselbe Integration, die Sie beim 2.5-Start ausführen werden. Das Einzige, was sich ändert, ist die Modellzeichenfolge.

Dieser Quickstart erfüllt also zwei Aufgaben. Er liefert heute ein echtes Video von einem echten Endpunkt und strukturiert Ihren Code und Ihre Prompts so, dass das Upgrade ein Ein-Zeilen-Diff ist.

Was tatsächlich in Seedance 2.5 ausgeliefert wird

Laut der offiziellen Seedance 2.5-Seite von ByteDance handelt es sich um ein Audio-Video-Joint-Generierungsmodell der nächsten Generation, das für 30-sekündiges Storytelling mit präziser Referenzkontrolle und leistungsstarker Bearbeitung entwickelt wurde. Die konkreten Behauptungen, die es wert sind, berücksichtigt zu werden:

• Bis zu 30 Sekunden in einer einzigen Generierung, mit der Option, zweimal zu verlängern, für längeres, vollständigeres Storytelling
• Sanftere und konsistentere Bewegung, mit realistischeren Bildern
• Präzisere Referenzvideo-Verständnis, Erfassung von Absicht, Framing und filmischer Sprache, anstatt nur Bewegung zu übertragen
• Zuverlässigere Bearbeitung über einen größeren Bereich von Audio- und visuellen Bearbeitungsanfragen
• White-Model-Steuerung und Green-Screen-Bearbeitung, plus professionelle Kamerabewegung und Performance-Blocking, ausgerichtet auf komplexe Produktionsworkflows

Beachten Sie, was nicht auf dieser Liste steht: keine Benchmark-Tabelle, keine Auflösungsleiter, keine Referenz-Asset-Anzahl. Alles, was Sie in dieser Richtung gesehen haben, ist der Marketing-Glanz von jemandem, nicht das Erstanbieter-Spezifikationsblatt. Bauen Sie auf den oben genannten Behauptungen auf.

Schritt 1: Holen Sie sich einen Schlüssel von der Konsole

Melden Sie sich unter console.atlascloud.ai an und erstellen Sie einen API-Schlüssel. Es gibt keine Einzahlung, keine Mindestverpflichtung und keine Warteliste, sodass der Schlüssel sofort auf Pay-as-you-go-Basis nutzbar ist. Ein Schlüssel deckt den gesamten Katalog von über 300 Modellen für Text, Bild und Video auf einem Abrechnungskonto ab, was für diesen Quickstart wichtig ist: Der Schlüssel, den Sie jetzt erstellen, ist derselbe Schlüssel, der Seedance 2.5 aufrufen wird.

Speichern Sie ihn als Umgebungsvariable, niemals im Quellcode. ATLASCLOUD_API_KEY ist ein guter Name.

Schritt 2: Senden Sie einen Videoauftrag

Die Videogenerierung auf Atlas Cloud ist ein zweistufiger asynchroner REST-Aufruf, keine Chat-Vervollständigung. Sie POSTen einen Auftrag und erhalten eine Vorhersage-ID zurück, dann fragen Sie diese ID ab, bis das Rendering abgeschlossen ist. Jeder HTTP-Client funktioniert, sodass kein Anbieter-SDK installiert und kein neues Authentifizierungsschema gelernt werden muss: Es ist ein Bearer-Token für den Schlüssel, den Sie gerade erstellt haben.

pythonCopy
1import os, time, requests
2
3KEY  = os.environ["ATLASCLOUD_API_KEY"]
4BASE = "https://api.atlascloud.ai/api/v1/model"
5HEND = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}
6
7job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
8    "model": "bytedance/seedance-2.0/text-to-video",
9    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
10              "neon reflections on wet asphalt, slight lag on turns.",
11    "duration": 5,
12    "resolution": "720p",
13    "ratio": "adaptive",
14    "bitrate_mode": "standard",
15    "generate_audio": True,
16    "watermark": False,
17}).json()
18
19prediction_id = job["data"]["id"]

Die Antwort kommt als {"code": 200, "data": {"id": "...", "status": "processing"}} zurück. Beachten Sie, dass model ein einfaches Zeichenfolgenfeld ist. Dieses Detail ist die gesamte Upgrade-Story für diesen Artikel, und Schritt 6 kommt darauf zurück.

Schritt 3: Abfragen, bis das Rendering abgeschlossen ist

Ein 5-Sekunden-Clip ist keine sofortige Antwort, behandeln Sie das Rendering also als einen Auftrag mit einem Lebenszyklus und nicht als einen blockierenden Aufruf. Fragen Sie den Vorhersage-Endpunkt ab, bis status einen Endwert erreicht.

pythonCopy
1while True:
2    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
3    status = r["data"]["status"]
4    if status in ("completed", "succeeded", "failed"):
5        break
6    time.sleep(3)
7
8print(status, r["data"])   # on success the payload carries the output URL(s)

Zwei Dinge, die es wert sind, jetzt und nicht später eingebaut zu werden. Setzen Sie eine Obergrenze für die Abfrageschleife, damit ein festgefahrener Auftrag keinen Anforderungs-Handler blockieren kann, und speichern Sie die Vorhersage-ID, bevor Sie mit der Abfrage beginnen, damit ein abgestürzter Worker fortfahren kann, anstatt zweimal für das Rendering zu bezahlen. Beide Gewohnheiten werden unverändert auf 2.5 übertragen.

Wenn Ihre Funktion von einem Referenzbild oder einer Subjekt-Referenz anstelle von reinem Text arbeitet, gilt derselbe Ablauf mit einer anderen Modellvariante, bytedance/seedance-2.0/image-to-video oder bytedance/seedance-2.0/reference-to-video. Subjekt-Referenz-Assets werden einmal über uploadMedia hochgeladen und dann als asset://<id> in den Bildfeldern übergeben, sodass ein wiederkehrender Charakter oder ein Produkt nicht bei jedem Aufruf erneut hochgeladen werden muss.

Schritt 4: Wählen Sie eine Live-Seedance-Stufe und wissen Sie, was eine Sekunde kostet

Atlas Cloud berechnet Videos pro Sekunde der Ausgabedauer. Das ist eine Rechnung, die Sie im Kopf machen können, bevor Sie Code schreiben. Drei Seedance-Stufen sind heute live:

Zur Orientierung: Andere Videomodelle mit demselben Schlüssel liegen in einem vergleichbaren Bereich: Grok Imagine Video v1.5 bei 0,080 $/s, Wan 2.7 bei 0,100 $/s, Kling V3.0 Turbo bei 0,112 $ Standard und 0,095 $ ermäßigt, MiniMax H3 bei 0,14 $/s.

Welches Modell Sie verwenden, hängt davon ab, was Ihre 2.5-Funktion letztendlich leisten soll. Wenn Audio für die Ausgabe zentral ist, ist Seedance 1.5 Pro die Stufe, die bereits native synchronisierte Audio und mehrsprachige Lippensynchronisation bietet, sodass Ihre Pipeline von Anfang an lernt, eine Audiospur zu verarbeiten. Wenn Sie die Prompt-Struktur iterieren und die niedrigsten Kosten pro Experiment wünschen, ist Seedance 2.0 Mini mit 0,056 $/s der offensichtliche Sandkasten. Wenn Sie das Nächstbeste zu einem produktionsreifen Rendering der aktuellen Generation wünschen, ist Seedance 2.0 mit 0,112 $/s die einfache Wahl, mit der Fast-Variante bei 0,09 $/s, wenn der Durchsatz wichtiger ist als die letzte Qualitätssteigerung.

Schritt 5: Überprüfen Sie den Live-Preis im Playground, bevor Sie Geld ausgeben

Bevor Sie Ihren ersten kostenpflichtigen Anruf tätigen, öffnen Sie das Modell im Atlas Cloud Playground. Jedes Modell zeigt seinen Live-Preis pro Modell neben der Schaltfläche „Run“ an. Das ist wichtiger, als es klingt: Werbeaktionen kommen und gehen, und die Zahl neben der Schaltfläche „Run“ ist diejenige, die tatsächlich abgerechnet wird. Führen Sie eine Generierung im Playground aus, bestätigen Sie, dass die Ausgabe das ist, was Ihre Funktion benötigt, und übertragen Sie dann die Einstellungen in den Code.

Das Modell „pro Sekunde der Ausgabe“ macht Ihre Budgetdiskussion auch trivial. Ein 10-Sekunden-Clip auf Seedance 2.0 Mini kostet 10 × 0,056 $. Es gibt keinen Rechner, keine Token-Schätzung und keinen nachträglichen Abgleichschritt.

Das ist es wert, mit der Art und Weise verglichen zu werden, wie ByteDance-Kanäle Seedance abrechnen. Auf Volcano Engine Ark in China und BytePlus ModelArk international erfolgt die Abrechnung tokenbasiert: Der geschätzte Token-Verbrauch beträgt (Eingabevideodauer + Ausgabevideodauer) × Ausgabebreite × Ausgabehöhe × Ausgabebildrate / 1024, multipliziert mit einem Token-Einheitspreis, wobei die tatsächliche Nutzung maßgeblich aus dem Feld usage.completion_tokens in der API-Antwort hervorgeht. Für die Seedance 2.0-Serie und Seedance 2.5, wenn die Eingabe Video enthält, gilt eine Mindest-Token-Verbrauchsuntergrenze, und die Untergrenze hängt von Auflösung, Seitenverhältnis und Ausgabedauer ab. ByteDance veröffentlicht aus genau diesem Grund einen Preisrechner plus eine Mindest-Token-Tabelle.

Beide Modelle sind legitim. Aber wenn Sie ein 30-Sekunden-Rendering budgetieren, ist die Dauer pro Sekunde der Ausgabe Kopfrechnen und Token mit Untergrenzen erfordert eine Tabelle.

Schritt 6: Schreiben Sie die Shot-Beschreibung, als wäre es bereits 2.5

Dies ist der Teil des Quickstarts, der perfekt übertragen wird, da die Prompt-Erstellung nicht versioniert ist. Zwei der 2.5-Funktionsansprüche sollten ändern, wie Sie heute schreiben.

Präzise Referenzkontrolle. ByteDances Behauptung ist, dass 2.5 ein Referenzvideo auf seine Absicht, Bildausschnitt und filmische Sprache liest und über die Bewegungsübertragung hinausgeht. Die Implikation für das Prompting ist, dass Ihr Referenz-Asset aufhört, eine Bewegungsvorlage zu sein, und beginnt, ein Regie-Briefing zu sein. Hören Sie also auf, Prompts zu schreiben, die nur das Motiv beschreiben, und beginnen Sie, die Grammatik zu benennen, die Sie übertragen möchten: das Objektivgefühl, den Bildausschnitt, das Tempo des Schnitts, ob die Kamera das Motiv führt oder folgt. Schreiben Sie „Handheld, subject-following medium shot, slight lag on turns“ anstelle von „person walking, cinematic“.

Dreißig Sekunden in einer einzigen Generierung. Ein 5-Sekunden-Clip ist eine Aufnahme. Dreißig Sekunden sind eine Szene mit Struktur, und 2.5 unterstützt die zweimalige Verlängerung darüber hinaus. Schreiben Sie also Shot-Beschreibungen mit einer Beat-Struktur anstelle einer einzigen statischen Beschreibung: einen etablierenden Beat, eine Änderung (eine Wendung, ein Eingang, eine Enthüllung) und eine Auflösung. Benennen Sie Kamerabewegungen und Performance-Blocking explizit, da dies genau die Kontrollen sind, auf die 2.5 abzielt. Wo das Motiv steht, wohin es sich bewegt, was die Kamera tut, während es sich bewegt.

Beide Gewohnheiten zahlen sich jetzt auf den Live-Stufen aus. Beide sind genau die Gewohnheiten, die 2.5 belohnt.

Schritt 7: Planen Sie den Austausch

Strukturieren Sie Ihren Code so, dass der Modellbezeichner eine Konfiguration und kein Literal ist. Eine Konstante, aus Umgebung oder Konfiguration gelesen:

pythonCopy
1SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")

Übergeben Sie dann SEEDANCE_MODEL, wo Schritt 2 die Zeichenfolge fest codiert hat. Da model ein einzelnes JSON-Zeichenfolgenfeld im generateVideo-Body ist, ist das Upgrade beim 2.5-Start wirklich eine Umgebungsvariable. Keine Metapher für eine kleine Änderung, buchstäblich ein Wert.

Hardcodieren Sie niemals heute eine Seedance 2.5-ID, da noch keine Atlas Cloud Seedance 2.5-Modell-ID existiert. Holen Sie die genauen Live-IDs aus dem Katalog unter atlascloud.ai/models, anstatt sie aus einem Artikel, einschließlich diesem, zu kopieren, da im Laufe der Zeit neue Varianten hinzugefügt werden. Wenn 2.5 unter der Day-0-Verpflichtung landet, besteht die Arbeit auf Ihrer Seite aus dieser einen Variablen, plus einem frischen Blick auf den Preis neben der Schaltfläche „Run“ und einem erneuten Lesen aller neuen Anforderungsparameter, da ein 30-Sekunden-Modell mit Erweiterungsunterstützung plausibel Felder akzeptiert, die der 2.0-Body nicht hat.

In der Zwischenzeit, wenn Sie Seedance 2.5 heute und nicht beim Atlas Cloud Start benötigen, ist die ehrliche Antwort die Erstanbieter-ByteDance-Kanäle: Volcano Engine Ark in China und BytePlus ModelArk international. Unter den Aggregatoren befinden sich mehrere im selben Vorab- oder Day-0-Verpflichtungszustand.

FAQ

F: Kann ich Seedance 2.5 jetzt auf Atlas Cloud aufrufen? A: Nein. Die Seedance 2.5 Familienseite auf Atlas Cloud ist als „Coming Soon“ gekennzeichnet, mit einer Day-0-Zugangsverpflichtung auf denselben vereinheitlichten Endpunkten, die bereits Seedance 2.0 und 1.5 bedienen. Es wurde noch keine Modell-ID und kein Preis dafür veröffentlicht.

F: Was kostet Seedance heute auf Atlas Cloud? A: Seedance 2.0 kostet 0,112 $/s, Seedance 2.0 Fast 0,09 $/s, Seedance 2.0 Mini 0,056 $/s und Seedance 1.5 Pro 0,047 $/s oder 0,018 $/s bei seiner Fast-Variante. Die Abrechnung erfolgt pro Sekunde der Ausgabedauer, und der Live-Preis wird neben der Schaltfläche „Run“ im Playground angezeigt.

F: Benötige ich ein spezielles SDK für Video auf Atlas Cloud? A: Nein. Video ist ein einfacher REST-Flow: POST /api/v1/model/generateVideo, um einen Auftrag zu senden, dann GET /api/v1/model/prediction/{id}, um ihn abzufragen, beides authentifiziert mit einem Bearer-Token auf Ihrem Atlas Cloud-Schlüssel. Jeder HTTP-Client funktioniert. Beachten Sie, dass Video nicht über den OpenAI-kompatiblen Chat-Endpunkt läuft, den der Textkatalog verwendet, erwarten Sie also nicht, dass chat.completions einen Clip rendert. Die anforderungsbezogenen Parameter pro Modell sind unter atlascloud.ai/docs dokumentiert.

F: Gibt es eine Einzahlung oder Mindestverpflichtung, um zu beginnen? A: Nein. Atlas Cloud ist Pay-as-you-go ohne Einzahlung, ohne Mindestverpflichtung und ohne Warteliste, und der Schlüssel von console.atlascloud.ai ist sofort nutzbar.

F: Welche Live-Stufe sollte ich prototypisieren, wenn ich 2.5 anstrebe? A: Seedance 2.0 Mini mit 0,056 $/s für günstige Prompt-Iterationen, Seedance 1.5 Pro, wenn Ihre Pipeline eine native synchronisierte Audiospur verarbeiten muss, und Seedance 2.0 mit 0,112 $/s für das nächstbeste Rendering der aktuellen Generation.

Fazit

Atlas Cloud betreibt heute Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini und Seedance 1.5 Pro mit einem API-Schlüssel und einer Abrechnung pro Sekunde der Ausgabedauer, SOC II-Zertifizierung, HIPAA-Konformität und Verschlüsselung im Ruhezustand und während der Übertragung, und hat eine Day-0-Verpflichtung veröffentlicht, Seedance 2.5 auf denselben vereinheitlichten Endpunkten zu bedienen, wenn es ausgeliefert wird.