Skip to main content
POST

Authentifizierung

string
erforderlich
Alle API-Endpunkte erfordern eine Bearer-Token-AuthentifizierungHolen Sie Ihren API Key:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API Key zu erhaltenFügen Sie ihn dem Anfrage-Header hinzu:

Anfrageparameter

string
erforderlich
Name des VideogenerierungsmodellsUnterstützte Modelle:
  • seedance-2.0 — Standardversion, unterstützt Text-zu-Video, Bild-zu-Video, Video aus erstem/letztem Frame, Referenzvideo, Referenzaudio und Video mit Audiospur
  • seedance-2.0-fast — Schnellversion, dieselben Funktionen wie die Standardversion bei höherer Generierungsgeschwindigkeit
  • seedance-2.0-mini — Mini-Version, dieselben Funktionen wie die Standardversion
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Videoauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
Geprüfte Inhalte:
  • Text: prompt, negative_prompt
  • Bilder: image_urls, image_with_roles[].url, first_frame_image, last_frame_image
  • Private Bild-Assets mit asset://: ursprüngliche öffentliche URL auflösen und prüfen
  • Base64-Bilder: nach der Umwandlung in eine öffentliche URL prüfen
video_urls, audio_urls sowie private Video- und Audio-Assets werden nicht geprüft, da das Moderationsmodell Video und Audio nicht unterstützt.Unterstützte Modell-IDs: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (alter Name) und seedance-2.5.Der Moderationsaufruf selbst wird dem Benutzer, der die Videoanfrage absendet, nicht berechnet.
  • Bei erkannten Inhalten wird synchron HTTP 400 (nsfw_content_detected) zurückgegeben. Es werden weder ein Auftrag noch eine task_id erstellt und kein Kontingent für die Videogenerierung abgezogen
  • Ist die Moderation nicht verfügbar, läuft in ein Timeout oder liefert eine ungültige Antwort, gilt fail-open und die Generierung wird fortgesetzt. Diese Option ist keine absolute Garantie für Inhaltssicherheit
  • Eingaben, die nicht in eine öffentliche Bild-URL aufgelöst werden können, werden übersprungen; nicht unterstützte Modelle ignorieren nsfw_check: true ohne Meldung
Beispiel:
Antwort bei Erkennung:
string
Beschreibung des VideoinhaltsErforderlich für Text-zu-Video; optional für Bild-zu-Video oder Video-Referenz-zu-VideoEs wird empfohlen, Motiv, Aktion, Kamerabewegung und Stil klar anzugeben, um bessere Generierungsergebnisse zu erzielen
  • Der Prompt ist auf 4000 Zeichen begrenzt, empfohlen werden jedoch 500 Zeichen.
  • Das Modell seedance-2.0-mini hat keine Zeichenbegrenzung. Empfehlung: Chinesische Prompts sollten 500 Zeichen und englische Prompts 1000 Wörter nicht überschreiten. Zu lange Texte führen leicht dazu, dass die Informationen verstreut werden, und das Modell könnte Details übersehen und sich nur auf die Schwerpunkte konzentrieren, wodurch im Video einige Elemente fehlen.
Beispiel: "A kitten yawning at the camera"
integer
Standard:"5"
Videodauer (in Sekunden)Unterstützter Bereich: 4 bis 15 SekundenStandard: 5
string
Standard:"16:9"
Seitenverhältnis des VideosDas Seitenverhältnis muss zwischen 0.5 und 2.5 liegenOptionen:
  • 16:9 — Querformat
  • 9:16 — Hochformat
  • 1:1 — Quadrat
  • 4:3 — Traditionelles Verhältnis
  • 3:4 — Vertikales traditionelles Verhältnis
  • 21:9 — Ultrabreit
  • adaptive — Adaptiv (passt sich automatisch an das eingegebene Bild/Video an)
Standard: 16:9
string
Standard:"720p"
VideoauflösungOptionen:
  • 480p — Standard Definition
  • 720p — High Definition
  • 1080p — Full HD (nur unterstützt von seedance-2.0)
  • 4k — Ultra HD (nur unterstützt von seedance-2.0)
Standard: 720p
integer
Zufalls-Seed zur Steuerung der Zufälligkeit des generierten Inhalts
  • Bei derselben Anfrage erzeugen unterschiedliche Seed-Werte unterschiedliche Ergebnisse
  • Bei derselben Anfrage erzeugt derselbe Seed-Wert ähnliche Ergebnisse, exakte Konsistenz ist jedoch nicht garantiert
boolean
Standard:"true"
Ob Audio generiert werden soll (Video mit Audiospur)Wenn auf true gesetzt, enthält das Video von der KI generiertes BegleitaudioWenn auf false gesetzt, enthält das Video kein Audio (stummes Video)Standard: true
boolean
Standard:"false"
Ob das Bild des letzten Frames zurückgegeben werden sollWenn auf true gesetzt, gibt das Aufgabenergebnis zusätzlich die URL des letzten Frames des Videos zurück, die für die kontinuierliche Videogenerierung verwendet werden kannStandard: false
array<object>
Werkzeugliste für erweiterte Funktionen wie WebsucheBeispiel: [{"type": "web_search"}]
array<string>
Array von Bild-URLs für Bild-zu-VideoUnterstützt zwei Formate:
  • Normale Bild-URL: https://example.com/cat.jpg
  • Asset-URL (genehmigtes Asset): asset://asset_a
Beispiel: ["https://example.com/cat.jpg"] oder ["asset://asset_a"]
Asset-URLs werden von allen Seedance-2.0-Modellen unterstützt: seedance-2.0, seedance-2.0-fast und seedance-2.0-mini.
  • image_urls und image_with_roles können nicht gleichzeitig verwendet werden
  • Maximal 9 Referenzbilder
array
Bild-Array mit Rollen, unterstützt die Angabe von erstem Frame/letztem Frame
Wenn das Feld url eine Asset-URL verwendet, werden alle Seedance-2.0-Modelle unterstützt: seedance-2.0, seedance-2.0-fast und seedance-2.0-mini.
Beispiel:
Asset-URL-Format:
  • image_urls und image_with_roles können nicht gleichzeitig verwendet werden
  • Bei Verwendung von Bildern des ersten/letzten Frames sind video_urls und audio_urls nicht verfügbar
array<string>
Array von Referenzvideo-URLsUnterstützt zwei Formate:
  • Normale Video-URL: https://example.com/reference.mp4
  • Asset-URL (genehmigtes Asset): asset://asset_a
Beispiel: ["https://example.com/reference.mp4"] oder ["asset://asset_a"]
Asset-URLs werden von allen Seedance-2.0-Modellen unterstützt: seedance-2.0, seedance-2.0-fast und seedance-2.0-mini.
  • Bei Verwendung von Bildern des ersten/letzten Frames (image_with_roles) sind Referenzvideos nicht verfügbar
  • Maximal 3 Referenzvideos, 1.8 s < Gesamtdauer < 15.2 s
  • Die Auflösung des Referenzvideos muss zwischen 480P und 720P liegen
array<string>
Array von Referenzaudio-URLsUnterstützt zwei Formate:
  • Normale Audio-URL: https://example.com/speech.wav
  • Asset-URL (genehmigtes Asset): asset://asset_a
Beispiel: ["https://example.com/speech.wav"] oder ["asset://asset_a"]
Asset-URLs werden von allen Seedance-2.0-Modellen unterstützt: seedance-2.0, seedance-2.0-fast und seedance-2.0-mini.
  • Bei Verwendung von Bildern des ersten/letzten Frames (image_with_roles) ist Referenzaudio nicht verfügbar
  • Maximal 3 Referenzaudiodateien, Gesamtdauer maximal 15 Sekunden
  • Referenzaudio muss zusammen mit Referenzbildern oder Referenzvideos verwendet werden

Antwort

integer
Antwortstatuscode, 200 bei Erfolg
array
Array der Antwortdaten

Anwendungsfälle

Fall 1: Text-zu-Video

Fall 2: Bild-zu-Video (erster Frame)

Fall 3: Video aus erstem/letztem Frame

Fall 4: Video aus Referenzvideo

Fall 5: Referenzvideo + Referenzaudio

Fall 6: Video mit Audiospur

Fall 7: Kontinuierliche Videogenerierung (letzten Frame zurückgeben)

Fall 8: Generierung mit Schnellversion

Fall 9: Referenzbilder + Referenzvideo + Referenzaudio (multimodales Video)

Kombinieren Sie Referenzbilder, Referenzvideo und Referenzaudio, um ein immersives Werbevideo aus der Ich-Perspektive zu erstellen. Ideal für Produktwerbung, Markenanzeigen und andere Szenarien, die das Zusammenführen von Materialien aus mehreren Quellen erfordern.

Fall 10: Bild-zu-Video mit Asset-URL

Genehmigte Assets virtueller Avatare können direkt als Referenzbilder übergeben werden, ohne sie erneut hochladen oder prüfen lassen zu müssen.

Fall 11: Referenz-Porträt mit Asset-URL angeben (image_with_roles)

Fall 12: Schnellversion + Asset-URL für Bild-zu-Video

Fall 13: Bild über Asset-URL + Referenzvideo (Bewegungsübertragung)

Kombinieren Sie ein genehmigtes Porträt-Asset mit einem Referenzvideo, um die Figur dazu zu bringen, bestimmte Bewegungen auszuführen.
Aufgabenergebnisse abfragenDie Videogenerierung ist eine asynchrone Aufgabe, die bei der Einreichung eine task_id zurückgibt. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um den Fortschritt und die Ergebnisse der Generierung abzufragen.

Unterschiede zur Version 1.5 Pro