Skip to main content
Dieser Artikel beschreibt eine Integrationsanleitung für die SeeDance Videos Generation API, die es ermöglicht, offizielle SeeDance-Videos durch Eingabe benutzerdefinierter Parameter zu generieren.

​
Antragsprozess

Um die SeeDance Videos Generation API zu nutzen, müssen Sie zunächst Ihr API-Token im Ace Data Cloud Dashboard abrufen und für zukünftige Verwendung aufbewahren. Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, wo Sie zur Registrierung und Anmeldung eingeladen werden. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um es kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr Guthaben aufladen.
📘 Vollständige Dokumentation: SeeDance Videos Generation API →

​
Grundlegende Nutzung

Zunächst sollten Sie die grundlegende Nutzung verstehen, indem Sie den Eingabetext content.text, den Typ content.type=text und das Modell model eingeben, um das verarbeitete Ergebnis zu erhalten. Die spezifischen Inhalte sind wie folgt:

Hier sehen wir, dass wir die Request-Header festgelegt haben, einschließlich:
  • accept: In welchem Format Sie die Antwort erhalten möchten, hier eingetragen als application/json, also im JSON-Format.
  • authorization: Der Schlüssel zum Aufrufen der API, den Sie nach der Beantragung direkt auswählen können.
Zusätzlich haben wir den Request-Body festgelegt, einschließlich:
  • model: Das Modell zur Generierung des Videos.
    • Seedance 1.x Serie: doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-1-0-lite-t2v-250428, doubao-seedance-1-0-lite-i2v-250428.
    • Seedance 2.0 Serie (unterstützt Charaktere und Audio-Video-Multimodalreferenzen): doubao-seedance-2-0-260128 (Standard), doubao-seedance-2-0-fast-260128 (schnell), doubao-seedance-2-0-mini-260615 (leicht).
    • Seedance 2.5: doubao-seedance-2-5-260628, unterstützt bis zu 30 Sekunden, reine Audio-Referenzen, mehr Materialien, Video-Bearbeitung und -Verlängerung.
  • content: Eingabewerte-Array, type kann text (Eingabetext), image_url (Referenzbild), audio_url (Referenzaudio), video_url (Referenzvideo) sein. Bilder können durch role für den Zweck angegeben werden: first_frame (erste Frame) / last_frame (letzte Frame) / reference_image (Charakter / Hauptreferenz).
  • resolution: Ausgaberesolution, wählbar 480p / 720p / 1080p / 4k. 2.5 unterstützt 480p, 720p, 1080p; 2.0 Fast/Mini unterstützt 480p, 720p; 2.0 Standard unterstützt bis zu 4k.
  • ratio: Seitenverhältnis, wählbar 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive.
  • duration: Videolänge (Sekunden, Ganzzahl). 1.0 Serie 2–12; 1.5 Pro 4–12; 2.0 Serie 4–15; 2.5 ist 4–30. 1.5/2.x unterstützt -1 (automatische Länge).
  • seed: Zufallszahl, Ganzzahl, -1 bis 4294967295.
  • camerafixed: Ob die Kamera fixiert ist, true / false.
  • watermark: Ob ein Wasserzeichen hinzugefügt werden soll, true / false.
  • generate_audio: Ob ein Video mit Ton generiert werden soll, true / false, unterstützt von Seedance 1.5 Pro und 2.x Serien.
  • return_last_frame: Ob die URL des letzten Bildes des Videos im Ergebnis zurückgegeben werden soll.
  • omni_reference_task_type: Nur 2.5; auto / reference / edit / extend.
  • output_format: Nur 2.5; mp4 / mov, standardmäßig mp4.
  • tools: Nur 2.5; derzeit unterstütztes web_search Online-Suchwerkzeug, kann die Anzahl der Ergebnisse, Schlüsselwörter und Suchquellen einschränken.
  • priority: 2.5 wählbare Aufgabenpriorität, Ganzzahl 0–9, standardmäßig 0.
  • safety_identifier: Stabiler anonymisierter Endbenutzer-Identifikator mit maximal 64 Zeichen; bitte verwenden Sie Hash oder interne anonyme ID, geben Sie keinen Namen, E-Mail oder Telefonnummer ein.
  • execution_expires_after: Zeitüberschreitung der Aufgabe (Sekunden), Bereich 3600–259200.
  • callback_url: Asynchrone Rückrufadresse, nach der Einstellung gibt die API sofort task_id zurück, die Ergebnisse werden an diese Adresse gesendet, wenn die Aufgabe abgeschlossen ist.
  • async: Optional, wenn auf true gesetzt, gibt die Schnittstelle sofort task_id zurück, ohne dass callback_url bereitgestellt werden muss, anschließend kann das Ergebnis über die entsprechende Aufgabenabfrage-Schnittstelle abgefragt werden.
Nach der Auswahl können Sie sehen, dass auf der rechten Seite auch der entsprechende Code generiert wurde, wie im Bild gezeigt:

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen. Wie im obigen Bild gezeigt, haben wir folgendes Ergebnis erhalten:
Die Rückgabe enthält mehrere Felder, die wie folgt beschrieben werden:
  • success, der Status der Videoerzeugungsaufgabe zu diesem Zeitpunkt.
  • task_id, die ID der Videoerzeugungsaufgabe zu diesem Zeitpunkt.
  • trace_id, die Verfolgungs-ID der Videoerzeugung zu diesem Zeitpunkt.
  • data, die Ergebnisliste der Videoerzeugungsaufgabe zu diesem Zeitpunkt.
    • task_id, die serverseitige ID der Videoerzeugungsaufgabe zu diesem Zeitpunkt.
    • video_url, der Video-Link der Videoerzeugungsaufgabe zu diesem Zeitpunkt.
    • status, der Status der Videoerzeugungsaufgabe zu diesem Zeitpunkt.
      • model, das Modell, das zur Generierung des Videos verwendet wurde.
Wir können sehen, dass wir zufriedenstellende Videoinformationen erhalten haben. Wir müssen nur die Video-URL aus data verwenden, um das generierte SeeDance-Video abzurufen. Wenn Sie den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren, zum Beispiel sieht der CURL-Code wie folgt aus:

​
Inline-Parameterbeschreibung

Am Ende des content[].text-Prompt kann durch das Hinzufügen von --parameter value die Generierungsparameter übergeben werden (alte Methode, schwache Validierung, bei falscher Eingabe wird automatisch der Standardwert verwendet). Die vollständige Parameterliste ist wie folgt:
Empfohlene Vorgehensweise: Verwenden Sie direkt die entsprechenden oberen Felder im Request Body (z. B. resolution, ratio usw.) für den starken Validierungsmodus. Bei falscher Eingabe der Parameter wird eine klare Fehlermeldung zurückgegeben, was die Fehlersuche erleichtert.

​
Generierung von Videos mit Ton

Seedance 1.5 Pro und 2.x Serien unterstützen die Generierung von Videos mit Audio durch den Parameter generate_audio:
Die 1.0-Serie unterstützt diesen Parameter nicht.

​
Seedance 2.5 Vollmodalität Generierung, Bearbeitung und Verlängerung

doubao-seedance-2-5-260628 unterstützt 480p / 720p / 1080p, 4–30 Sekunden oder automatische Dauer und erhöht die Materialobergrenze auf 30 Referenzbilder, 10 Referenzvideos, 10 Referenzaudio (insgesamt maximal 50). 2.5 unterstützt auch die Übertragung von nur Referenzaudio, ohne dass gleichzeitig Bilder oder Videos bereitgestellt werden müssen. Die normale Vollmodalitätsgenerierung kann omni_reference_task_type weglassen, auf auto setzen oder explizit auf reference setzen. Video-Bearbeitung und Verlängerung müssen reference_video übergeben:
  • reference: Mindestens ein reference_image, reference_video oder reference_audio muss übergeben werden; 2.5 unterstützt nur die Übertragung von Referenzaudio.
  • edit: Muss ratio: adaptive und duration: -1 verwenden; die Ausgabelänge wird nach dem tatsächlichen Ergebnis abgerechnet.
  • extend: Muss ratio: adaptive verwenden; duration kann 4–30 oder -1 sein.
  • auto: Das Modell wählt automatisch basierend auf dem Prompt und dem Material Generierung, Bearbeitung oder Verlängerung aus.
  • Wenn der Aufgabentyp nicht mit dem Material oder dem Prompt übereinstimmt, schlägt die Aufgabe fehl und gibt einen lokalisierbaren Parameterfehler zurück; bitte passen Sie die oben genannten Einschränkungen an und reichen Sie erneut ein.

​
Bildgenerierung für das erste Video-Frame

Wenn Sie ein Bildgenerierungsvideo-Task möchten, muss der content-Parameter zunächst einen Eintrag mit type als image_url enthalten, das image_url-Feld muss im Objektformat sein: {"url": "https://..."} oder im Base64-Format {"url": "data:image/png;base64,..."}.
Hinweis: image_url unterstützt nicht die direkte Übergabe im String-Format (z. B. "image_url": "https://cdn.acedata.cloud/e724d7f13d.png"), es muss das Objektformat "image_url": {"url": "https://..."} verwendet werden, andernfalls wird ein 400-Fehler zurückgegeben.
Entsprechender Code:
Wenn Sie auf Ausführen klicken, werden Sie sofort ein Ergebnis erhalten, wie folgt:
Man kann sehen, dass das generierte Ergebnis das Bildgenerierungsvideo ist, das Ergebnis ist ähnlich wie oben beschrieben.

​
Bildgenerierung für das erste und letzte Video-Frame

Wenn Sie ein Bildgenerierungsvideo für das erste und letzte Frame möchten, muss der Parameter content zunächst den Typ image_url übergeben, und die role muss jeweils auf first_frame und last_frame gesetzt werden, um die folgenden Inhalte anzugeben:
  • role: Gibt das erste oder letzte Frame an.
  • image_url
    • url Bildlink Gleichzeitig muss content auch den Typ text als Prompt-Hinweis enthalten.
Entsprechender Code:
Wenn Sie auf Ausführen klicken, können Sie sofort ein Ergebnis erhalten, wie folgt:
Es ist zu sehen, dass der generierte Effekt ein Charakter-Video ist, das Ergebnis ähnelt dem oben.

​
Charakter und Audio-Video-Multimodalreferenz (Seedance 2.0)

Seedance 2.0 Serie (doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615) unterstützt reference_image, reference_audio und reference_video. Sie können eigene oder lizenziertes Material verwenden, um die Konsistenz von Charakter, Subjekt, Bewegung, Kameraführung, Klang und Rhythmus zu gewährleisten.
Bitte laden Sie nur eigenes oder lizenziertes Material von echten Personen und Charakteren hoch. Verschiedene Modelle unterstützen echtes Material unterschiedlich; das Anfrageformat bleibt unverändert, wenn das Material nicht den Anforderungen entspricht, wird ein klarer Fehler zurückgegeben.
Wichtige Punkte zur Verwendung:
  • Nur Seedance 2.0 Serie Modelle unterstützen reference_image; 1.x Modelle verwenden bitte first_frame / last_frame (Bild erzeugt Video Anfangs- und Endrahmen).
  • Bild erzeugt Video Anfangsrahmen, Bild erzeugt Video Anfangs- und Endrahmen und vollständige multimodale Referenz sind drei sich gegenseitig ausschließende Szenarien: first_frame / last_frame dürfen nicht mit reference_image / reference_video / reference_audio gemischt werden.
  • Wenn Sie in der vollständigen multimodalen Referenz Anfangs- und Endrahmen angeben möchten, kennzeichnen Sie das Bild als reference_image und geben Sie in den Eingabetexten an „Bild 1 als Anfangsrahmen“ oder „Bild 2 als Endrahmen“; wenn Sie die Anfangs- und Endrahmen strikt festlegen möchten, verwenden Sie nur first_frame / last_frame.
  • Obergrenze für die Anzahl der multimodalen Referenzen: image_url maximal 9 Bilder; 2.0 unterstützt auch audio_url (role ist reference_audio, maximal 3) und video_url (role ist reference_video, maximal 3).
  • Anforderungen an Referenzaudio (audio_url) Material: Format wav / mp3; Einzelne Dauer 2~15 Sekunden, maximal 3 und Gesamtdauer nicht mehr als 15 Sekunden; Einzelne nicht mehr als 15 MB. Überschreitet die Dauer die Grenzen, schlägt die Materialverarbeitung fehl.
  • Anforderungen an Referenzvideo (video_url) Material: Format mp4 / mov; Einzelne Dauer 2~15 Sekunden, maximal 3 und Gesamtdauer nicht mehr als 15 Sekunden.
  • Es wird empfohlen, Referenzbilder von einer Person, frontal, klar und ohne Hindernisse zu verwenden; je klarer das Gesicht, desto höher die Ähnlichkeit.

​
Beispiel 1: Nahaufnahme, die das Aussehen der Person bewahrt

Übergeben Sie ein Foto des Gesichts, damit die Person in die Kamera lächelt und winkt. Der entsprechende Code:
Das Rückgabeergebnis sieht wie folgt aus, das generierte Video behält das Aussehen der Person im Vergleich zum Referenzfoto:

​
Beispiel 2: Die gleiche Person in einer neuen Szene platzieren

Die Stärke von reference_image liegt darin, dass nur die Identität der Person beibehalten wird, während Szene, Kleidung und Bewegung vollständig durch die Eingabetexte bestimmt werden. Hier verwenden wir dasselbe Gesichtsfoto, um die Person in einem beigen Mantel durch einen sonnigen Herbstpark gehen zu lassen:
Das Rückgabeergebnis sieht wie folgt aus, das Aussehen der Person bleibt erhalten, während die Szene auf einen Herbstpark gewechselt wurde:
💡 Wenn Sie möchten, dass die Personen die Komposition des Fotos genau nachbilden (anstatt „die gleiche Person in einer anderen Szene“), können Sie first_frame (das erste Bild des Videos) verwenden, um das Video von diesem Foto aus zu starten.

​
Asynchrone Rückrufe

Da die Generierung von SeeDance-Videos über die API länger dauert (ca. 1-2 Minuten), können Sie das asynchrone Modell über das Feld callback_url verwenden, um zu vermeiden, dass die HTTP-Verbindung lange blockiert wird. Gesamtprozess: Der Client gibt bei der Anfrage callback_url an, die API gibt sofort eine Antwort mit der task_id zurück; nach Abschluss der Aufgabe sendet die Plattform die generierten Ergebnisse in Form von POST JSON an die callback_url, die Ergebnisse enthalten ebenfalls die task_id, um die Zuordnung zu ermöglichen.
Wenn die Aufgabe abgeschlossen ist, sieht der Inhalt, der an die callback_url gesendet wird, wie folgt aus:
Das Feld task_id in den Ergebnissen stimmt mit dem überein, das bei der Anfrage zurückgegeben wurde, und über dieses Feld kann die Zuordnung der Aufgaben erfolgen.

​
Fehlerbehandlung

Wenn beim Aufruf der API ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die Informationen zurück. Zum Beispiel:
  • 400 token_mismatched: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
  • 400 api_not_implemented: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
  • 401 invalid_token: Unbefugt, ungültiges oder fehlendes Autorisierungstoken.
  • 429 too_many_requests: Zu viele Anfragen, Sie haben das Kontingent überschritten.
  • 500 api_error: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

​
Beispiel für eine Fehlerantwort

​
Fazit

Durch dieses Dokument haben Sie gelernt, wie Sie die Seedance Videos Generation API zur Erstellung von Videos aus Text, zur Verwendung von Anfangs- und Endbildern sowie zur multimodalen Referenzgenerierung nutzen können, sowie wie Sie Seedance 2.5 zur Bearbeitung oder Verlängerung von Videos verwenden. Wir hoffen, dass dieses Dokument Ihnen bei der API-Integration hilft; bei Fragen wenden Sie sich bitte an den technischen Support.