Seedance 2.5: Der Sample-Modus ist jetzt auf APIYI verfügbar – Anleitung zum Aufruf vom 480p-Musterclip zum fertigen 1080p-Video in 2 Schritten

Autorennotiz: Dieser Artikel erklärt den zweistufigen Aufruf im Seedance-2.5-Entwurfsmodus. Erzeugen Sie zunächst kostengünstig einen Entwurf in 480p und erstellen Sie nach der Prüfung ein fertiges Video in 1080p. Mit direkt ausführbaren Anfragebeispielen.

Bei der KI-Videogenerierung tritt häufig folgendes Problem auf: Man erstellt sofort das hochauflösende fertige Video, doch Bildkomposition, Kameraführung oder Bewegungen des Hauptmotivs stimmen nicht. Dann muss das Video erneut generiert werden – das kostet Zeit und Geld. Am 25. Oktober 2026 hat APIYI die vollständige Anleitung zum Seedance-2.5-Entwurfsmodus (Draft Mode) ergänzt. Damit können Sie Ihre Idee zunächst mit einem Entwurf in 480p überprüfen und anschließend mithilfe der Aufgaben-ID des Entwurfs ein fertiges Video in 1080p erstellen.

Dies ist keine neue, eigenständige Schnittstelle. Der Entwurfsmodus nutzt die bestehende asynchrone Aufgabenschnittstelle von Seedance. Sie müssen lediglich draft: true zum Anfragekörper hinzufügen oder in der zweiten Phase auf die Aufgaben-ID des Entwurfs verweisen. Bei Projekten, die Seedance bereits nutzen, sind nur geringfügige Änderungen nötig.

Der zentrale Nutzen: Nach der Lektüre kennen Sie den zweistufigen Aufrufablauf, die wichtigsten Parameter, die Abrechnungsregeln und die Einschränkungen des Seedance-2.5-Entwurfsmodus. Außerdem können Sie den Workflow „erst den Entwurf prüfen, dann das fertige Video erstellen“ in Ihre eigene Videoproduktionspipeline integrieren.

Seedance 2.5: Die wichtigsten Punkte zum Vorschaumodus

Laut dem APIYI-Dokumentationsportal lassen sich die wichtigsten Informationen zum Vorschaumodus von Seedance 2.5 in der folgenden Tabelle zusammenfassen:

Warum sich der Vorschaumodus von Seedance 2.5 lohnt

Die Videogenerierung unterscheidet sich in einem wichtigen Punkt von der Textgenerierung: Eine einzelne Generierung dauert länger, ist teurer und liefert weniger vorhersehbare Ergebnisse. Selbst eine sehr detaillierte Eingabeaufforderung garantiert nicht, dass das Modell den gewünschten Rhythmus der Kamerabewegungen oder die Aktionen des Hauptmotivs richtig umsetzt. Wer jedes Mal direkt ein Video mit 1080p generiert, bezahlt bei einem unbefriedigenden Ergebnis jedes Mal für ein vollständiges Video.

Der Vorschaumodus teilt den Ablauf in zwei Schritte auf: „Probeaufnahme“ und „Dreh“. Ein Vorschauvideo mit 480p reicht aus, um das Hauptmotiv, die Richtung der Kamerabewegungen und die allgemeine Stimmung zu beurteilen. Erst wenn alles passt, wird auf dieser Grundlage das fertige Video mit 1080p generiert. Für Teams, die Kurzvideos, Werbematerial oder Storyboard-Vorschauen in großen Mengen produzieren, lässt sich so der Anteil unbrauchbarer Videos deutlich senken.

Die beiden Phasen des Seedance-2.5-Vorschaumodus

Wichtig ist: Das fertige Video entsteht nicht einfach durch Hochskalieren des Vorschauvideos. In der zweiten Phase wird eine neue Generierungsaufgabe erstellt, die über draft_task.id auf die Aufgabe für das Vorschauvideo verweist, die zugehörigen Einstellungen aus der Vorschauphase übernimmt und das Ergebnis anschließend mit 1080p ausgibt. Welche Parameter übernommen werden und welche sich in der zweiten Phase nicht ändern lassen, steht im Abschnitt „Parameterübernahme und Einschränkungen“ der APIYI-Dokumentation.

Schnellstart: Seedance 2.5 im Entwurfsmodus

Erstellen Sie zunächst in der APIYI-Konsole unter apiyi.com einen API-Schlüssel und legen Sie ihn als Umgebungsvariable APIYI_API_KEY fest. Die folgenden Beispiele lesen den Schlüssel aus der Umgebungsvariable, damit er nicht im Code steht.

Schritt 1: Einen Entwurf in 480p erstellen

Mit der folgenden Minimalanfrage erstellen Sie einen Entwurf. Entscheidend sind "draft": true und die Auflösung 480p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进"}
    ],
    "draft": true,
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": false
  }'

Der Aufruf läuft asynchron. Nach erfolgreicher Erstellung erhalten Sie eine Aufgaben-ID. Speichern Sie diese ID: Sie benötigen sie, um das Ergebnis des Entwurfs abzufragen und daraus das fertige Video zu erstellen.

Schritt 1: Parameter der Anfrage

Der Header Accept-Encoding: identity weist den Server an, die Antwort nicht zu komprimieren. Dadurch können manche Clients das Ergebnis direkt verarbeiten. Es empfiehlt sich, den Header beizubehalten.

Schritt 2: Status des Vorschauauftrags abfragen

Nach dem Erstellen eines Vorschauauftrags muss sein Status regelmäßig abgefragt werden, bis der Auftrag erfolgreich abgeschlossen ist und die Video-URL vorliegt. Dafür wird die vorhandene Schnittstelle für asynchrone Aufträge verwendet. In der Regel wird die Aufgaben-ID an die Auftrags-URL angehängt und eine GET-Anfrage gesendet. Der genaue Pfad und die zurückgegebenen Felder sind der APIYI-Dokumentation zu entnehmen:

curl -X GET "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/${TASK_ID}" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Accept-Encoding: identity"

Ein Abfrageintervall von 5 bis 10 Sekunden ist empfehlenswert. Häufigere Abfragen sind nicht sinnvoll und können stattdessen eine Ratenbegrenzung auslösen.

Schritt 3: Mit der Aufgaben-ID des Entwurfs das fertige Video in 1080p erzeugen

Wenn Sie mit dem Entwurf zufrieden sind, verweisen Sie im Array content über draft_task.id auf die Entwurfsaufgabe und setzen Sie die Auflösung auf 1080p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "YOUR_DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

Ersetzen Sie YOUR_DRAFT_TASK_ID durch die Aufgaben-ID des Entwurfs, die im ersten Schritt zurückgegeben wurde. Welche Werte das Feld type in den Elementen von content annehmen kann und welche weiteren optionalen Parameter verfügbar sind, entnehmen Sie den Beispielen für zweistufige Anfragen in der Dokumentation. Auch die Aufgabe für das fertige Video wird asynchron ausgeführt. Rufen Sie den Status wie im zweiten Schritt ab, um das Video in 1080p zu erhalten.

import os
import time
import requests

API_KEY = os.environ["APIYI_API_KEY"]
BASE_URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"  # APIYI-Schnittstelle für asynchrone Seedance-Aufgaben
MODEL = "doubao-seedance-2-5-260628"

HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Accept-Encoding": "identity",
}


def create_task(payload: dict) -> str:
    """Erstellt eine asynchrone Aufgabe und gibt deren ID zurück."""
    resp = requests.post(BASE_URL, headers=HEADERS, json=payload, timeout=60)
    resp.raise_for_status()
    data = resp.json()
    return data["id"]


def wait_task(task_id: str, interval: int = 8, timeout: int = 900) -> dict:
    """Fragt den Aufgabenstatus so lange ab, bis die Aufgabe erfolgreich abgeschlossen wurde oder fehlschlägt."""
    start = time.time()
    while time.time() - start < timeout:
        resp = requests.get(f"{BASE_URL}/{task_id}", headers=HEADERS, timeout=30)
        resp.raise_for_status()
        data = resp.json()
        status = data.get("status")
        print(f"[{task_id}] status = {status}")
        if status == "succeeded":
            return data
        if status in ("failed", "cancelled", "expired"):
            raise RuntimeError(f"Aufgabe beendet, aber nicht erfolgreich: {data}")
        time.sleep(interval)
    raise TimeoutError(f"Zeitüberschreitung beim Abfragen der Aufgabe {task_id}")


def generate_draft(prompt: str) -> str:
    """Erste Phase: Entwurf in 480p erzeugen."""
    payload = {
        "model": MODEL,
        "content": [{"type": "text", "text": prompt}],
        "draft": True,
        "resolution": "480p",
        "ratio": "16:9",
        "duration": 4,
        "generate_audio": False,
    }
    task_id = create_task(payload)
    result = wait_task(task_id)
    print("样片结果:", result.get("content"))
    return task_id


def generate_final(draft_task_id: str) -> dict:
    """Zweite Phase: Mit der Aufgaben-ID des Entwurfs das fertige Video in 1080p erzeugen."""
    payload = {
        "model": MODEL,
        "content": [
            {"type": "draft_task", "draft_task": {"id": draft_task_id}}
        ],
        "resolution": "1080p",
    }
    task_id = create_task(payload)
    return wait_task(task_id)


if __name__ == "__main__":
    draft_id = generate_draft("一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进")
    ok = input("样片是否满意？(y/n): ").strip().lower()
    if ok == "y":
        final = generate_final(draft_id)
        print("成片结果:", final.get("content"))
    else:
        print("请调整提示词后重新生成样片。")

🚀 Schnellstart: Am besten sichern Sie sich zuerst auf APIYI apiyi.com ein kostenloses Testguthaben für Neukunden. Optimieren Sie Ihre Eingabeaufforderungen anhand von 480p-Vorschauclips, bis die Ergebnisse zuverlässig sind, und erstellen Sie anschließend die fertigen Videos in 1080p im Batch. Die Plattform rechnet einheitlich über einen API-Schlüssel ab. So lassen sich die Aufrufkosten mehrerer Videoprojekte einfach verwalten.

Seedance 2.5: Vorschauclips oder direkt fertige Videos?

Ob Sie mit Vorschauclips arbeiten, hängt davon ab, wie wichtig Ihnen verlässliche Ergebnisse und eine schnelle Lieferung sind. Die folgende Tabelle vergleicht beide Aufrufvarianten:

Einordnung des Vorschauclip-Modus von Seedance 2.5

Die direkte Erstellung des fertigen Videos hat den Vorteil eines einfachen Ablaufs: Mit einer Anfrage erhalten Sie das endgültige Video. Sind jedoch das Hauptmotiv oder die Kameraführung nicht überzeugend, sind sowohl die Kosten als auch die Wartezeit für das gesamte Video in 1080p verloren. Beim Vorschauclip-Modus finden Tests und Anpassungen dagegen zunächst in einer niedrigeren Auflösung statt. Er eignet sich daher besser für Projekte, bei denen die Eingabeaufforderung mehrfach angepasst werden muss oder der Kunde zunächst die gestalterische Richtung freigeben soll.

Wenn Ihre Vorlagen für Eingabeaufforderungen bereits umfassend getestet wurden und relativ zuverlässige Ergebnisse liefern, ist die direkte Erstellung des fertigen Videos ebenfalls eine sinnvolle Wahl. In der Praxis bietet es sich an, für neue Ideen und Vorlagen den Vorschauclip-Modus zu nutzen und bei bewährten Vorlagen direkt das fertige Video zu erstellen. Beide Varianten lassen sich jederzeit über dieselbe asynchrone Schnittstelle wechseln.

💡 Empfehlung: Um die tatsächlichen Unterschiede bei den Ergebnissen einzuschätzen, sollten Sie beide Varianten mit mehreren Eingabeaufforderungen aus Ihrem eigenen Anwendungsfall testen. Bei Aufrufen über APIYI apiyi.com verwenden beide Modi dieselbe Schnittstelle und denselben API-Schlüssel. Zum Wechseln müssen Sie lediglich die Parameter im Anfragetext anpassen.

Hinweise zur Integration des Seedance-2.5-Vorschaumodus

Bei der Integration des Vorschaumodus in eine Produktionsumgebung werden einige Details leicht übersehen. Die folgende Tabelle fasst häufige Punkte zusammen:

Empfehlungen zur Workflow-Gestaltung für den Seedance-2.5-Vorschaumodus

Für die Zusammenarbeit im Team empfiehlt es sich, den Vorschaumodus in einen dreistufigen Ablauf aufzuteilen: „Erstellen – Prüfen – Freigeben“. Das System erstellt Vorschauen in großen Mengen und leitet sie an die Prüfenden weiter. Die IDs freigegebener Vorschauaufträge werden in die Warteschlange für fertige Videos übernommen. Abgelehnte Vorschauen gehen mit den Änderungshinweisen zurück zur Anpassung der Eingabeaufforderung. So konzentriert sich die manuelle Prüfung auf die kostengünstige Vorschauphase.

Bei stärker automatisierten Pipelines kann bereits in der Vorschauphase ein multimodales Modell zur Vorauswahl eingesetzt werden, etwa um zu prüfen, ob das vorgegebene Motiv im Bild erscheint oder deutliche Verzerrungen vorliegen. Nach bestandener Vorauswahl erfolgt die manuelle Prüfung. So lässt sich der Prüfaufwand weiter reduzieren. Da APIYI einheitliche Schnittstellen für mehrere führende Modelle bereitstellt, können Videogenerierung und multimodale Prüfung mit demselben API-Schlüssel erfolgen.

Häufige Fragen (FAQ)

Die wichtigsten Punkte zum Seedance-2.5-Vorschaumodus

• Zweistufiger Ablauf: Erstellen Sie zunächst mit draft: true einen Vorschauclip in 480p und verwenden Sie anschließend die Aufgaben-ID, um das finale Video in 1080p zu generieren.
• Unveränderte Schnittstelle: Der Ablauf nutzt weiterhin die vorhandene asynchrone Seedance-Aufgabenschnittstelle. Für bereits angebundene Projekte sind daher nur minimale Änderungen nötig.
• Wichtiges Feld: In der Phase der finalen Videoerstellung wird mit content[].draft_task.id auf die Aufgabe des Vorschauclips verwiesen.
• Abrechnung: Vorschauclip und finales Video werden separat abgerechnet. Die Kosten für das finale Video fallen nur bei Vorschauclips an, mit denen Sie zufrieden sind.
• Zeitliche Einschränkung: Die Aufgaben-ID eines Vorschauclips ist 7 Tage lang gültig. Prüfen und genehmigen Sie Clips daher rechtzeitig.
• Geeignete Anwendungsfälle: Besonders vorteilhaft ist der Modus bei der kreativen Ideenfindung, der Kundenfreigabe und der Auswahl von Materialien in großen Mengen.
• So legen Sie los: Sichern Sie sich bei APIYI auf apiyi.com ein kostenloses Guthaben und führen Sie mit den Beispielen in diesem Artikel den gesamten Ablauf durch.

Zusammenfassung

Die wichtigsten Punkte zum Vorschauclip-Modus von Seedance 2.5:

1. Erst testen, dann produzieren: Mit Vorschauclips in 480p lassen sich Bildkomposition und Kameraführung kostengünstig prüfen. So sinkt die Ausschussquote bei 1080p.
2. Einfach einzubinden: Ergänzen Sie einfach den Parameter draft und verweisen Sie auf draft_task.id. Die bestehende asynchrone Schnittstelle kann weiterverwendet werden.
3. Gültigkeit und Abrechnung beachten: Die ID eines Vorschauclips ist 7 Tage gültig. Vorschauclips und fertige Videos werden separat abgerechnet.

Wenn Sie bei Ihrer Videoanwendung häufig die Eingabeaufforderungen anpassen müssen, lohnt sich die zeitnahe Einbindung des Vorschauclip-Modus. Wählen Sie zunächst einige typische Eingabeaufforderungen aus und testen Sie den Ablauf „Vorschauclip → fertiges Video“. Anschließend können Sie Wirkung und Kosten bewerten und den Modus bei Bedarf in der Serienproduktion einsetzen.

Über APIYI apiyi.com können Sie die praktische Wirkung des Vorschauclip-Modus von Seedance 2.5 schnell testen. Die Plattform bietet eine OpenAI-kompatible Schnittstelle, nutzungsbasierte Abrechnung und ein kostenloses Testkontingent für neue Nutzer.

📚 Referenzen

1. APIYI-Dokumentation zur Seedance-2-Videogenerierung – Vorschauclip-Modus: Offizielle Anleitung zur Verwendung des Vorschauclip-Modus von Seedance 2.5
2. Link: docs.apiyi.com/api-capabilities/seedance2/video-generation#draft-mode

3. Beschreibung: Enthält Beispiele für Anfragen in zwei Phasen sowie Informationen zur Übernahme und zu den Einschränkungen von Parametern, zur Abrechnung und zur Gültigkeitsdauer.

4. APIYI-Dokumentationszentrum: Dokumentation zu allen Modellschnittstellen der Plattform

5. Link: docs.apiyi.com
6. Beschreibung: Hier finden Sie einen Überblick zur Modellauswahl bei Seedance sowie Informationen zur Verwendung anderer Modelle.

Autor: Das technische Team von APIYI
Technischer Austausch: Wenn bei der Einbindung Fragen auftreten, kontaktieren Sie uns gern über die Startseite von APIYI apiyi.com. Weitere Informationen finden Sie im Dokumentationszentrum unter docs.apiyi.com.

Weiterführende Artikel

• Praxisleitfaden zu SeeDance2.5 für die Erstellung und Bearbeitung von Videos mit Gesichtern: Reales Personenmaterial in 3 Schritten erfassen und regelkonform aufrufen: Erkläre den korrekten Weg zur Videoerzeugung und -bearbeitung mit Gesichtern in SeeDance2.5: Material realer Personen in die Asset-Bibliothek aufnehmen, die Asset-ID abrufen und per asset://-Referenz aufrufen sowie klären, ob eine Gesichtsverdeckung nötig ist und warum das direkte Hochladen von Gesichtsvideos blockiert wird.