curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "draft_unavailable",
    "message": "Draft mode is not available on the selected service right now. Retry later or send the request without draft.",
    "type": "invalid_request_error"
  }
}

Seedance 2.5

Seedance 2.5 Vollständige Parameterreferenz

Vollständige Parameterreferenz für Seedance 2.5. Wählen Sie mit model ein Modell dieses Ordners. Pflichtfelder, Eingabeanforderungen und Abrechnung sind je Modus aufgeführt.

Modell-ID	Modus	Pflichtfelder (ohne model)
`seedance-2.5-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.5-reference-to-video`	Reference-to-Video	`prompt`
`seedance-2.5-video-edit`	Video Edit	`prompt`, `video_urls`
`seedance-2.5-video-extend`	Video Extend	`prompt`, `video_urls`
`seedance-2.5-draft-to-video`	Draft-to-Video	`source_task_id`

Text-to-Video

Videogenerierung aus reinen Textprompts, unterstützt Websuche zur Verbesserung der Aktualität
Unterstützt jetzt AIGC-Real-Person-Materialien
Unterstützt den Entwurfsmodus: Mit draft: true erstellen Sie zunächst einen 480p-Entwurf. Wenn Sie zufrieden sind, wandeln Sie ihn mit Draft-to-Video in ein finales 1080p-Video um. Beide Anfragen werden separat abgerechnet
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur Abfrage
Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie ihn rechtzeitig

Image-to-Video

1 Bild eingeben für Startbild-Video, 2 Bilder eingeben für Start-/Endbild-Video, das Modell erkennt dies automatisch
Unterstützt jetzt AIGC-Real-Person-Materialien
Unterstützt den Entwurfsmodus: Mit draft: true erstellen Sie zunächst einen 480p-Entwurf. Wenn Sie zufrieden sind, wandeln Sie ihn mit Draft-to-Video in ein finales 1080p-Video um. Beide Anfragen werden separat abgerechnet
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur Abfrage
Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie ihn rechtzeitig

Reference-to-Video

Eingabe von Referenzbildern (0-30) + Referenzvideos (0-10) + Referenzaudio (0-10) + Textprompt zur Videogenerierung; mindestens ein Bild, Video oder Audio muss angegeben werden
Geeignet für Neuerstellungen: Bilder, Videos und Audio dienen als Referenz für Stil, Motiv, Kameraführung und Musik
Zum Umschreiben oder Fortsetzen eines vorhandenen Videos bitte Video Edit / Video Extend verwenden: Sobald der Prompt dieses Modells eine Bearbeitungs- oder Verlängerungsabsicht enthält, werden die Parameter als Bearbeitungs- / Verlängerungsaufgabe geprüft — die Anfrage wird ohne Fehler angenommen und die Aufgabe schlägt erst während der Generierung fehl
Unterstützt jetzt AIGC-Real-Person-Materialien
Unterstützt den Entwurfsmodus: Mit draft: true erstellen Sie zunächst einen 480p-Entwurf. Wenn Sie zufrieden sind, wandeln Sie ihn mit Draft-to-Video in ein finales 1080p-Video um. Beide Anfragen werden separat abgerechnet
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur Abfrage
Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie ihn rechtzeitig

Video Edit

Bearbeitung eines Eingabevideos — Motive ersetzen, Objekte hinzufügen/entfernen, Bereiche umgestalten oder neu einfärben
Der Prompt muss die Bearbeitungsabsicht nennen (z. B. “Video bearbeiten: Hintergrundmusik von @video1 entfernen”)
Eingabe des zu bearbeitenden Videos (erforderlich) + optionale Referenzbilder (0–30) + Referenzvideos (insgesamt bis zu 10) + Referenzaudio (0–10)
Unterstützt jetzt AIGC-Real-Person-Materialien
Unterstützt den Entwurfsmodus: Mit draft: true erstellen Sie zunächst einen 480p-Entwurf. Wenn Sie zufrieden sind, wandeln Sie ihn mit Draft-to-Video in ein finales 1080p-Video um. Beide Anfragen werden separat abgerechnet
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur Abfrage
Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie ihn rechtzeitig

Video Extend

Verlängert ein Eingabevideo nach vorne oder nach hinten
Der Prompt muss die Verlängerungsabsicht nennen (z. B. “@video1 nach hinten verlängern, die Figur läuft aus dem Bild”)
Eingabe des zu verlängernden Videos (erforderlich) + optionale Referenzbilder (0–30) + Referenzvideos (insgesamt bis zu 10) + Referenzaudio (0–10)
Unterstützt jetzt AIGC-Real-Person-Materialien
Unterstützt den Entwurfsmodus: Mit draft: true erstellen Sie zunächst einen 480p-Entwurf. Wenn Sie zufrieden sind, wandeln Sie ihn mit Draft-to-Video in ein finales 1080p-Video um. Beide Anfragen werden separat abgerechnet
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zur Abfrage
Der generierte Video-Link ist 24 Stunden gültig, bitte speichern Sie ihn rechtzeitig

Draft-to-Video

Wandelt einen fertigen Seedance-2.5-Entwurf (eine mit draft: true erstellte Aufgabe) in ein finales 1080p-Video mit demselben Inhalt um
Es werden nur vier Felder akzeptiert: model, source_task_id, output_format und callback_url. Prompt, Materialien, Dauer, Seitenverhältnis, Seed und Audioeinstellungen werden vollständig vom Entwurf übernommen. Diese Felder dürfen nicht erneut übergeben werden; jedes andere Feld führt zu einem 400-Parameterfehler
Senden Sie die Konvertierungsanfrage vor draft_expires_at des Entwurfs. Die Gültigkeitsdauer beträgt standardmäßig 24 Stunden ab Fertigstellung des Entwurfs; maßgeblich ist der tatsächliche Wert von draft_expires_at aus der Aufgabenabfrage
Die Gültigkeit wird sowohl bei Annahme der Anfrage als auch vor Übergabe zur Generierung geprüft. Läuft der Entwurf in der Warteschlange ab, schlägt die Konvertierungsaufgabe fehl und ihre Kosten werden erstattet. Planen Sie daher Wartezeit ein
Derselbe Entwurf kann innerhalb seiner Gültigkeitsdauer mehrfach konvertiert werden; jede Konvertierung wird separat abgerechnet
Asynchroner Verarbeitungsmodus: Verwenden Sie die zurückgegebene Aufgaben-ID zur Statusabfrage. Die Antwort enthält source_task_id
Generierte Video-Links sind 24 Stunden gültig; speichern Sie die Dateien rechtzeitig

Abrechnungsregeln:

Wird separat vom Entwurf und immer zum 1080p-Tarif abgerechnet
Als Ausgabedauer gilt die für den Quellentwurf gespeicherte tatsächliche Ausgabedauer. Fehlt dieser Wert, wird die für die Quellaufgabe gespeicherte effektive Ausgabedauer verwendet
Abrechenbare Dauer: ohne Videoeingabe die Ausgabedauer; mit Videoeingabe (einschließlich Reference-to-Video, Video Edit und Video Extend) Ausgabedauer + max(Eingabevideodauer, Ausgabedauer). In beiden Fällen wird auf die nächste 0,1 Sekunde aufgerundet
War der Inhaltsfilter für den Entwurf deaktiviert (content_filter: false), wird auch das finale Video mit +10 % (1.1x) abgerechnet
Schlägt die Konvertierung fehl, werden die Kosten dieser Konvertierung erstattet; die Kosten des Entwurfs werden nicht erstattet

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "draft_unavailable",
    "message": "Draft mode is not available on the selected service right now. Retry later or send the request without draft.",
    "type": "invalid_request_error"
  }
}

Autorisierungen

Authorization

string

header

erforderlich

##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer Token##

API Key erhalten:

Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API Key zu erhalten

Fügen Sie ihn im Anfrage-Header hinzu:

Authorization: Bearer YOUR_API_KEY

Body

application/json

Diese Seite fasst die Parameter aller Modi zusammen. Pflichtfelder, zulässige Werte und Standardwerte richten sich nach dem gewählten model; die Unterschiede sind unten je Modus aufgeführt.

model

enum<string>

erforderlich

Name des Videogenerierungsmodells

Modell-ID	Modus	Pflichtfelder (ohne model)
`seedance-2.5-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.5-reference-to-video`	Reference-to-Video	`prompt`
`seedance-2.5-video-edit`	Video Edit	`prompt`, `video_urls`
`seedance-2.5-video-extend`	Video Extend	`prompt`, `video_urls`
`seedance-2.5-draft-to-video`	Draft-to-Video	`source_task_id`

Verfügbare Optionen:

seedance-2.5-text-to-video,

seedance-2.5-image-to-video,

seedance-2.5-reference-to-video,

seedance-2.5-video-edit,

seedance-2.5-video-extend,

seedance-2.5-draft-to-video

Beispiel:

"seedance-2.5-text-to-video"

prompt

string

Gilt nur für: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video

Textprompt zur Beschreibung des gewünschten Videos. Unterstützt Chinesisch und Englisch, empfohlen max. 500 Zeichen auf Chinesisch, max. 1000 Wörter auf Englisch. Maximale Prompt-Länge: 10000 Tokens

Hinweis:

Dieses Modell ist ein reines Text-to-Video-Modell und unterstützt keine Eingabe von image_urls, video_urls oder audio_urls

Image-to-Video

Hinweis:

Dieses Modell unterstützt keine Eingabe von video_urls oder audio_urls

Reference-to-Video

Textprompt zur Beschreibung des gewünschten Videos. Unterstützt Chinesisch und Englisch, empfohlen max. 500 Zeichen auf Chinesisch. Maximale Prompt-Länge: 10000 Tokens

Hinweise:

Verwenden Sie beim Verweisen auf Eingabematerialien im Prompt bevorzugt explizite Tags wie @image1, @video1 und @audio1, statt sich nur auf natürlichsprachliche Bezeichnungen wie „Bild 1“, „Video 1“ oder „Audio 1“ zu verlassen
Die Tag-Nummern entsprechen der Reihenfolge im jeweiligen URL-Array und beginnen bei 1: Der erste Eintrag in image_urls ist @image1, der erste in video_urls ist @video1 und der erste in audio_urls ist @audio1
Natürlichsprachliche Nummerierungen können weiterhin erkannt werden, explizite Tags ordnen Materialien und Verwendungszwecke jedoch eindeutiger zu

Einstufung als Bearbeitungs- / Verlängerungsaufgabe vermeiden:

Der Aufgabentyp wird aus der Prompt-Absicht abgeleitet: Formulierungen wie „Video bearbeiten“, „hinzufügen“, „löschen / entfernen“, „ändern / ersetzen“ gelten als Videobearbeitung; Formulierungen wie „nach vorne / hinten verlängern“ oder „fortsetzen“ gelten als Videoverlängerung
Sobald die Aufgabe so eingestuft wird, muss aspect_ratio den Wert adaptive haben und bei der Videobearbeitung duration den Wert -1; andernfalls wird die Anfrage ohne Fehler angenommen und die Aufgabe endet später mit failed (Fehlercode InvalidParameter.TaskTypeConstraint). Das vorab reservierte Guthaben wird erstattet, die Wartezeit ist jedoch verloren
Wenn Sie tatsächlich bearbeiten oder verlängern möchten, verwenden Sie direkt seedance-2.5-video-edit bzw. seedance-2.5-video-extend: Die Parameter werden beim Absenden geprüft, ungültige Werte führen sofort zu einem synchronen Fehler
Für reine Referenzgenerierung formulieren Sie Wörter wie „ersetzen“ oder „entfernen“ beschreibend um, z. B. „im Bild erscheint …“ oder „im Stil von @image1 dargestellt“

Video Edit

Text-Prompt zur Beschreibung der gewünschten Bearbeitung. Unterstützt Chinesisch und Englisch, für Chinesisch werden maximal 500 Zeichen empfohlen. Maximale Prompt-Länge: 10000 Tokens

Details:

Der Prompt muss die Bearbeitungsabsicht nennen, z. B. "Video bearbeiten: Hintergrundmusik von @video1 entfernen"
Der Zweck jedes Materials kann in natürlicher Sprache angegeben werden, z. B. "die Figur in @video1 durch die Person aus @image1 ersetzen"
Das Modell erkennt die Zuordnung zwischen Materialnummern und ihrem Verwendungszweck automatisch

Video Extend

Text-Prompt zur Beschreibung der gewünschten Verlängerung. Unterstützt Chinesisch und Englisch, für Chinesisch werden maximal 500 Zeichen empfohlen. Maximale Prompt-Länge: 10000 Tokens

Details:

Der Prompt muss die Verlängerungsabsicht nennen, z. B. "@video1 nach hinten verlängern, die Figur läuft aus dem Bild"
Der Zweck jedes Materials kann in natürlicher Sprache angegeben werden, z. B. "@video1 im Stil von @image1 nach vorne verlängern"
Das Modell erkennt die Zuordnung zwischen Materialnummern und ihrem Verwendungszweck automatisch

Beispiel:

"A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically."

source_task_id

string

Gilt nur für: Draft-to-Video

Aufgaben-ID eines fertigen Seedance-2.5-Entwurfs

Wo Sie die ID finden: Im Feld id der Antwort beim Erstellen eines Entwurfs (draft: true)

Voraussetzungen:

Die Aufgabe muss zum aktuellen Konto gehören
Die Aufgabe muss eines der fünf Seedance-2.5-Generierungsmodelle verwenden
Die Aufgabe muss mit draft: true erstellt worden sein
Der Aufgabenstatus muss completed sein
Die aktuelle Zeit muss vor draft_expires_at aus der Aufgabenabfrage liegen

Beispiel:

"task-unified-1774857405-abc123"

image_urls

string<uri>[]

Gilt nur für: Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Image-to-Video

Bild-URL-Array, 1-2 Bilder

Bildanzahl und Verhalten:

Bildanzahl	Verhalten	Rolle
1 Bild	Startbild-Video	Automatisch als `first_frame` gesetzt
2 Bilder	Start-/Endbild-Video	Bild 1 → `first_frame`, Bild 2 → `last_frame`

Bildanforderungen:

Unterstützte Formate: .jpeg, .png, .webp
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Einzelbildgröße: maximal 30MB
Gesamtgröße des Anfragekörpers maximal 64MB
Bei Start-/Endbildern können beide Bilder identisch sein. Bei unterschiedlichen Seitenverhältnissen wird das Startbild als Referenz verwendet, das Endbild wird automatisch zugeschnitten
Bild-URLs müssen für den Server direkt zugänglich sein

Reference-to-Video

Referenzbild-URL-Array, optional; bei Angabe 1-30 Bilder

Pflichtangabe: Mindestens eines von image_urls, video_urls oder audio_urls muss angegeben werden.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Bild	`reference_image`	Stilreferenz, Produktbild, Startbild/Endbild (über Prompt festlegen)

Bildanforderungen:

Unterstützte Formate: .jpeg, .png, .webp
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Einzelbildgröße: maximal 30MB
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Bild-URLs müssen für den Server direkt zugänglich sein

Video Edit

Referenzbild-URL-Array, optional; bei Angabe 1-30 Bilder

Voraussetzung: Für dieses Modell ist video_urls erforderlich; Bilder sind optionale ergänzende Referenzen.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Bild	`reference_image`	Stilreferenz, Produktbild, zu ersetzendes Motiv (per Prompt angegeben)

Bildanforderungen:

Unterstützte Formate: .jpeg, .png, .webp
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Einzelbildgröße: maximal 30MB
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Bild-URLs müssen für den Server direkt zugänglich sein

Video Extend

Referenzbild-URL-Array, optional; bei Angabe 1-30 Bilder

Voraussetzung: Für dieses Modell ist video_urls erforderlich; Bilder sind optionale ergänzende Referenzen.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Bild	`reference_image`	Stilreferenz, Produktbild, Szenenreferenz (per Prompt angegeben)

Bildanforderungen:

Unterstützte Formate: .jpeg, .png, .webp
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Einzelbildgröße: maximal 30MB
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Bild-URLs müssen für den Server direkt zugänglich sein

Required array length: 1 - 30 elements

Beispiel:

["https://example.com/first-frame.jpg"]

video_urls

string<uri>[]

Gilt nur für: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

Referenzvideo-URL-Array, optional; bei Angabe 1-10 Videos

Pflichtangabe: Mindestens eines von image_urls, video_urls oder audio_urls muss angegeben werden.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Video	`reference_video`	Kameraführungsreferenz, Bewegungsreferenz, zu bearbeitendes/verlängerndes Originalvideo

Videoanforderungen:

Unterstützte Formate: .mp4, .mov
Auflösung: 480p, 720p, 1080p, 4K
Einzelvideodauer: 2 ~ 30 Sekunden, maximal 10 Videos, Gesamtdauer aller Videos ≤ 30 Sekunden
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Bildpixel (Breite × Höhe): 409.600 ~ 8.295.044 (z.B. 640×640 ~ 3326×2494)
Einzelgröße: maximal 200MB
Bildrate: 24 ~ 60 FPS
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Die Gültigkeit von Codec, Auflösung und weiteren Medieneigenschaften wird zusätzlich vom Modell geprüft
Die Verwendung von Videoreferenzen verursacht zusätzliche Kosten (Eingabevideodauer wird in die Abrechnung einbezogen)
Video-URLs müssen für den Server direkt zugänglich sein

Video Edit

Array mit Eingabevideo-URLs, erforderlich; 1–10 Videos

Voraussetzung: Mindestens 1 Video erforderlich — das zu bearbeitende Video. Das erste Video ist das Bearbeitungsziel, weitere Videos dienen als Referenz.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Video	`reference_video`	Das zu bearbeitende Video (erstes Video), Kamerafahrt- oder Bewegungsreferenz (weitere Videos)

Videoanforderungen:

Unterstützte Formate: .mp4, .mov
Auflösung: 480p, 720p, 1080p, 4K
Einzelvideodauer: 4 ~ 30 Sekunden (das erste Video ist das Bearbeitungsziel), maximal 10 Videos, Gesamtdauer aller Videos ≤ 30 Sekunden
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Bildpixel (Breite × Höhe): 409.600 ~ 8.295.044 (z.B. 640×640 ~ 3326×2494)
Einzelgröße: maximal 200MB
Bildrate: 24 ~ 60 FPS
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Die Gültigkeit von Codec, Auflösung und weiteren Medieneigenschaften wird zusätzlich vom Modell geprüft
Die Verwendung von Videoreferenzen verursacht zusätzliche Kosten (Eingabevideodauer wird in die Abrechnung einbezogen)
Video-URLs müssen für den Server direkt zugänglich sein

Video Extend

Array mit Eingabevideo-URLs, erforderlich; 1–10 Videos

Voraussetzung: Mindestens 1 Video erforderlich — das zu verlängernde Video. Das erste Video ist das Verlängerungsziel, weitere Videos dienen als Referenz.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Video	`reference_video`	Das zu verlängernde Video (erstes Video), Kamerafahrt- oder Bewegungsreferenz (weitere Videos)

Videoanforderungen:

Unterstützte Formate: .mp4, .mov
Auflösung: 480p, 720p, 1080p, 4K
Einzelvideodauer: 2 ~ 30 Sekunden, maximal 10 Videos, Gesamtdauer aller Videos ≤ 30 Sekunden
Seitenverhältnis (Breite/Höhe): 0.4 ~ 2.5
Breite/Höhe in Pixel: 300 ~ 6000 px
Bildpixel (Breite × Höhe): 409.600 ~ 8.295.044 (z.B. 640×640 ~ 3326×2494)
Einzelgröße: maximal 200MB
Bildrate: 24 ~ 60 FPS
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Die Gültigkeit von Codec, Auflösung und weiteren Medieneigenschaften wird zusätzlich vom Modell geprüft
Die Verwendung von Videoreferenzen verursacht zusätzliche Kosten (Eingabevideodauer wird in die Abrechnung einbezogen)
Video-URLs müssen für den Server direkt zugänglich sein

Required array length: 1 - 10 elements

Beispiel:

["https://example.com/reference.mp4"]

audio_urls

string<uri>[]

Gilt nur für: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

Referenzaudio-URL-Array, optional; bei Angabe 1-10 Audiodateien

Pflichtangabe: Mindestens eines von image_urls, video_urls oder audio_urls muss angegeben werden.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Audio	`reference_audio`	Hintergrundmusik, Soundeffekte, Sprach-/Dialogreferenz

Audioanforderungen:

Unterstützte Formate: .wav, .mp3
Einzelaudiodauer: 2 ~ 30 Sekunden, maximal 10 Dateien, Gesamtdauer aller Audiodateien ≤ 30 Sekunden
Einzelgröße: maximal 15MB
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Audio-URLs müssen für den Server direkt zugänglich sein

Video Edit / Video Extend

Referenzaudio-URL-Array, optional; bei Angabe 1-10 Audiodateien

Voraussetzung: Für dieses Modell ist video_urls erforderlich; Audio ist eine optionale ergänzende Referenz.

Rollenbeschreibung:

Medientyp	Rolle	Typische Verwendung
Audio	`reference_audio`	Hintergrundmusik, Soundeffekte, Sprach-/Dialogreferenz

Audioanforderungen:

Unterstützte Formate: .wav, .mp3
Einzelaudiodauer: 2 ~ 30 Sekunden, maximal 10 Dateien, Gesamtdauer aller Audiodateien ≤ 30 Sekunden
Einzelgröße: maximal 15MB
Gesamtgröße des Anfragekörpers maximal 64MB, verwenden Sie keine Base64-Kodierung
Audio-URLs müssen für den Server direkt zugänglich sein

Required array length: 1 - 10 elements

Beispiel:

["https://example.com/bgm.mp3"]

duration

integer

Gilt nur für: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video / Image-to-Video

Videodauer (Sekunden), Standard ist 5 Sekunden

Hinweise:

Unterstützt beliebige Ganzzahlwerte zwischen 4 und 30 Sekunden
-1: automatische Dauer, das Modell wählt eine Länge zwischen 4–30 Sekunden, abgerechnet wird nach der tatsächlichen Ausgabelänge
Die Dauer wirkt sich direkt auf die Abrechnung aus

Reference-to-Video

Ausgabe-Videodauer (Sekunden), Standard ist 5 Sekunden

Hinweise:

Unterstützt beliebige Ganzzahlwerte zwischen 4 und 30 Sekunden
-1: automatische Dauer, das Modell wählt eine Länge zwischen 4–30 Sekunden, abgerechnet wird nach der tatsächlichen Ausgabelänge
Die Dauer wirkt sich direkt auf die Abrechnung aus

Wird der Prompt als Videobearbeitungsaufgabe eingestuft, ist nur -1 zulässig; eine konkrete Sekundenangabe lässt die Aufgabe später fehlschlagen, ohne Fehler beim Absenden

Video Edit

Ausgabedauer des Videos (Sekunden), Standard ist -1

Details:

Nur -1 wird unterstützt: die Ausgabelänge folgt dem Eingabevideo (kann bis zu 0,4 s kürzer sein)
Eigene Dauerangaben werden abgelehnt
Die Dauer wirkt sich direkt auf die Abrechnung aus

Video Extend

Ausgabedauer des Videos (Sekunden), Standard ist 5 Sekunden

Details:

Unterstützt jeden ganzzahligen Wert zwischen 4–30 Sekunden
-1: automatische Dauer, abgerechnet nach der tatsächlichen Ausgabelänge
Die Dauer wirkt sich direkt auf die Abrechnung aus

Beispiel:

8

quality

enum<string>

Standard:720p

Gilt nur für: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Videoauflösung, Standard ist 720p

Verfügbare Werte:

480p: Niedrigere Auflösung, günstigerer Preis
720p: Standardauflösung, dies ist der Standardwert
1080p: Ultra-HD-Auflösung

Entwurfsmodus: Wenn draft auf true gesetzt ist, wird nur 480p unterstützt. Wird quality weggelassen, wird automatisch 480p verwendet

Verfügbare Optionen:

480p,

720p,

1080p

Beispiel:

"720p"

draft

boolean

Standard:false

Gilt nur für: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Schalter für den Entwurfsmodus, Standard ist false

Details:

true: Erstellt zunächst einen 480p-Entwurf mit kürzerer Generierungszeit und regulärer 480p-Abrechnung
Bei aktiviertem Entwurfsmodus muss quality entweder 480p sein oder weggelassen werden. Andere Auflösungen führen zu einem 400-Parameterfehler
Darf nur auf der obersten Ebene des Anfragekörpers stehen. Innerhalb von model_params führt das Feld zu einem 400-Parameterfehler

In ein finales Video umwandeln:

Sobald der Entwurf fertig ist, liefert die Aufgabenabfrage das Feld draft_expires_at
Übergeben Sie vor diesem Zeitpunkt die Aufgaben-ID des Entwurfs an Seedance 2.5 Draft-to-Video, um ein finales 1080p-Video mit demselben Inhalt zu erstellen
Das finale Video und der Entwurf werden separat abgerechnet. Wenn Sie mit dem Entwurf nicht zufrieden sind, können Sie auf die Konvertierung verzichten und zahlen nur für den Entwurf
Die Gültigkeitsdauer beträgt standardmäßig 24 Stunden ab Fertigstellung des Entwurfs; maßgeblich ist draft_expires_at. Senden Sie die Konvertierungsanfrage frühzeitig: Läuft der Entwurf in der Warteschlange ab, schlägt die Konvertierung ebenfalls fehl

Vorübergehend nicht verfügbar: Wenn der Dienst vorübergehend nicht verfügbar ist, kann ein 503-Fehler zurückgegeben werden. Bei Fehlercode draft_unavailable versuchen Sie es später erneut oder entfernen Sie draft, um den normalen Generierungsmodus zu verwenden

Beispiel:

false

aspect_ratio

enum<string>

Standard:adaptive

Gilt nur für: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video

Video-Seitenverhältnis, Standard ist adaptive

Verfügbare Werte:

16:9 (Querformat), 9:16 (Hochformat), 1:1 (Quadrat), 4:3, 3:4, 21:9 (Ultraweitbild)
adaptive: Das Modell wählt intelligent das beste Seitenverhältnis basierend auf dem Prompt

Pixelwerte pro Auflösung:

Seitenverhältnis	480p	720p	1080p
16:9	854×480	1280×720	1920×1080
4:3	752×560	1112×834	1664×1248
1:1	640×640	960×960	1440×1440
3:4	560×752	834×1112	1248×1664
9:16	480×854	720×1280	1080×1920
21:9	992×432	1470×630	2206×946

Image-to-Video

Video-Seitenverhältnis, Image-to-Video unterstützt nur adaptive

Verfügbare Werte:

adaptive: Wählt automatisch das nächstliegende Seitenverhältnis basierend auf dem Startbild, der einzige für dieses Modell zulässige Wert
Feste Seitenverhältnisse wie 16:9 oder 9:16 können für dieses Modell nicht angegeben werden

Reference-to-Video

Video-Seitenverhältnis, Standard ist adaptive

Verfügbare Werte:

16:9 (Querformat), 9:16 (Hochformat), 1:1 (Quadrat), 4:3, 3:4, 21:9 (Ultraweitbild)
adaptive: Basiert auf der Prompt-Intention, Priorität: Video > Bild > Prompt

Pixelwerte pro Auflösung:

Seitenverhältnis	480p	720p	1080p
16:9	854×480	1280×720	1920×1080
4:3	752×560	1112×834	1664×1248
1:1	640×640	960×960	1440×1440
3:4	560×752	834×1112	1248×1664
9:16	480×854	720×1280	1080×1920
21:9	992×432	1470×630	2206×946

Wird der Prompt als Bearbeitungs- / Verlängerungsaufgabe eingestuft, ist nur adaptive zulässig; ein festes Seitenverhältnis lässt die Aufgabe später fehlschlagen, ohne Fehler beim Absenden

Video Edit / Video Extend

Video-Seitenverhältnis, Standard ist adaptive

Verfügbare Werte:

adaptive: Das Ausgabeverhältnis folgt dem ersten Eingabevideo, der einzige für dieses Modell zulässige Wert
Feste Seitenverhältnisse wie 16:9 oder 9:16 werden abgelehnt

Verfügbare Optionen:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

Beispiel:

"16:9"

generate_audio

boolean

Standard:true

Gilt nur für: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video

Ob synchronisiertes Audio generiert werden soll, Standard ist true

Verfügbare Werte:

true: Video enthält synchronisiertes Audio (Stimmen, Soundeffekte, Hintergrundmusik), keine zusätzlichen Kosten. Es wird empfohlen, Dialogteile in Anführungszeichen zu setzen, um die Audiogenerierung zu optimieren
false: Stummes Video ausgeben

Image-to-Video / Reference-to-Video / Video Edit / Video Extend

Ob synchronisiertes Audio generiert werden soll, Standard ist true

Verfügbare Werte:

true: Video enthält synchronisiertes Audio, keine zusätzlichen Kosten
false: Stummes Video ausgeben

Beispiel:

true

content_filter

boolean

Standard:true

Gilt nur für: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Inhaltsfilter, Standard ist true

Verfügbare Werte:

true: Standardmäßige Inhaltssicherheitsprüfung, dies ist der Standard
false: Lockert die Inhaltsbeschränkungen, Abrechnung mit +10% (1.1x). Illegale und verbotene Inhalte werden unabhängig von dieser Einstellung immer durchgesetzt

Nicht mit der Websuche kombinierbar:

content_filter: false und model_params.web_search: true können nicht zusammen verwendet werden; werden beide gesendet, wird ein 400-Parameterfehler zurückgegeben
Behalten Sie content_filter: true (Standard) bei, wenn die Websuche benötigt wird

Beispiel:

true

output_format

enum<string>

Standard:mp4

Text-to-Video / Image-to-Video / Reference-to-Video / Video Edit / Video Extend

Ausgabe-Containerformat, Standard ist mp4

Verfügbare Werte:

mp4: H.264-Kodierung mit bester Kompatibilität und standardmäßiger Farbpräzision, dies ist der Standard
mov: H.264 + yuv444p-Chroma-Sampling + PCM-Audio für höhere Farbtreue, empfohlen für Color-Grading-, Keying- und Compositing-Workflows. Die Wiedergabe im Browser wird möglicherweise nicht unterstützt; laden Sie die Datei herunter und spielen Sie sie mit VLC / mpv / ffplay ab. Keine zusätzlichen Kosten

Draft-to-Video

Ausgabe-Containerformat, Standard ist mp4

Verfügbare Werte:

mp4: Standard-Containerformat. Dieser Endpunkt gibt 1080p-Videos mit 10-Bit-Farbtiefe und H.265/HEVC-Kodierung aus. Für die Wiedergabe ist Unterstützung für 10-Bit-HEVC erforderlich; reine H.264-Player können das Video möglicherweise nicht abspielen
mov: H.264 + yuv444p-Chroma-Sampling + PCM-Audio für höhere Farbtreue, empfohlen für Color-Grading-, Keying- und Compositing-Workflows. Die Wiedergabe im Browser wird möglicherweise nicht unterstützt; laden Sie die Datei herunter und spielen Sie sie mit VLC / mpv / ffplay ab. Keine zusätzlichen Kosten

Das Ausgabeformat des Entwurfs wird nicht übernommen. Geben Sie hier bei Bedarf mov an

Verfügbare Optionen:

mp4,

mov

Beispiel:

"mp4"

model_params

object

Gilt nur für: Text-to-Video

Erweiterte Modellparameter

Show child attributes

callback_url

string<uri>

HTTPS-Callback-URL nach Aufgabenabschluss

Callback-Zeitpunkte:

Wird bei Aufgabenabschluss (completed) oder Fehler (failed) ausgelöst
Wird nach Bestätigung der Abrechnung gesendet

Sicherheitseinschränkungen:

Nur HTTPS-Protokoll unterstützt
Callbacks an interne IP-Adressen sind verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.)
URL-Länge maximal 2048 Zeichen

Callback-Mechanismus:

Timeout: 10 Sekunden
Maximal 3 Wiederholungsversuche nach Fehler (jeweils nach 1/2/4 Sekunden)
Das Format des Callback-Antwortkörpers entspricht dem Rückgabeformat der Aufgabenabfrage-Schnittstelle
Ein 2xx-Statuscode gilt als Erfolg, andere Statuscodes lösen Wiederholungsversuche aus

Beispiel:

"https://your-domain.com/webhooks/video-task-completed"

Antwort

Videogenerierungsaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1761313744

string

Aufgaben-ID

Beispiel:

"task-unified-1774857405-abc123"

model

string

Tatsächlich verwendeter Modellname

Beispiel:

"seedance-2.5-text-to-video"

object

enum<string>

Spezifischer Aufgabentyp

Verfügbare Optionen:

video.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed

Beispiel:

"pending"

task_info

object

Detaillierte Informationen zur Videoaufgabe

Show child attributes

type

enum<string>

Ausgabetyp der Aufgabe

Verfügbare Optionen:

text,

image,

audio,

video

Beispiel:

"video"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Seedance 2.5 Vollständige Parameterreferenz

Text-to-Video

Image-to-Video

Reference-to-Video

Video Edit

Video Extend

Draft-to-Video

Autorisierungen

Body

Antwort