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-flash-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-flash-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-flash-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": "<string>",
    "message": "<string>",
    "type": "<string>"
  }
}

Seedance 2.5 Flash

Seedance 2.5 Flash Vollständige Parameterreferenz

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

Entwurfsmodus: Seedance 2.5 Flash unterstützt weder draft: true noch die Konvertierung eines Entwurfs in ein finales Video.

Websuche bei Text-to-Video: model_params.web_search: true und content_filter: false sind nicht kombinierbar; beide zusammen führen zu einem 400-Parameterfehler. Für die Websuche content_filter: true (Standard) beibehalten.

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

Text-to-Video

Videogenerierung aus reinen Textprompts, unterstützt Websuche zur Verbesserung der Aktualität

Image-to-Video

1 Bild eingeben für Startbild-Video, 2 Bilder eingeben für Start-/Endbild-Video, das Modell erkennt dies automatisch

Reference-to-Video

Videogenerierung aus einem Textprompt mit optionalen Referenzbildern (0–10), Videos (0–5) und Audiodateien (0–5). Alle Referenzen können entfallen; auch reine Audioreferenzen werden unterstützt.
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

Video Edit

Bearbeitung eines Eingabevideos — Motive ersetzen, Objekte hinzufügen/entfernen, Bereiche umgestalten oder neu einfärben
Beschreiben Sie die Änderung direkt im Prompt, z. B. “Alle Passanten in @video1 entfernen, nur die Hauptfigur behalten”
Eingabe des zu bearbeitenden Videos (erforderlich) + optionale Referenzbilder (0–10) + Referenzvideos (insgesamt bis zu 5) + Referenzaudio (0–5)

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–10) + Referenzvideos (insgesamt bis zu 5) + Referenzaudio (0–5)
Unterstützt jetzt AIGC-Real-Person-Materialien
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

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-flash-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-flash-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-flash-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": "<string>",
    "message": "<string>",
    "type": "<string>"
  }
}

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-flash-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-flash-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.5-flash-reference-to-video`	Reference-to-Video	`prompt`
`seedance-2.5-flash-video-edit`	Video Edit	`prompt`, `video_urls`
`seedance-2.5-flash-video-extend`	Video Extend	`prompt`, `video_urls`

Verfügbare Optionen:

seedance-2.5-flash-text-to-video,

seedance-2.5-flash-image-to-video,

seedance-2.5-flash-reference-to-video,

seedance-2.5-flash-video-edit,

seedance-2.5-flash-video-extend

Beispiel:

"seedance-2.5-flash-text-to-video"

prompt

string

erforderlich

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-flash-video-edit bzw. seedance-2.5-flash-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."

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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Reference-to-Video

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

Optionale Referenzen: image_urls, video_urls und audio_urls können alle entfallen. Auch nur audio_urls ist zulässig.

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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Video Edit

Referenzbild-URL-Array, optional; bei Angabe 1-10 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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Video Extend

Referenzbild-URL-Array, optional; bei Angabe 1-10 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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Maximum array length: 10

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-5 Videos

Optionale Referenzen: image_urls, video_urls und audio_urls können alle entfallen. Auch nur audio_urls ist zulässig.

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 5 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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Video Edit

Array mit Eingabevideo-URLs, erforderlich; 1–5 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 5 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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Video Extend

Array mit Eingabevideo-URLs, erforderlich; 1–5 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 5 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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Maximum array length: 5

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-5 Audiodateien

Optionale Referenzen: image_urls, video_urls und audio_urls können alle entfallen. Auch nur audio_urls ist zulässig.

Rollenbeschreibung:

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

Audioanforderungen:

Unterstützte Formate: .wav, .mp3
Einzelaudiodauer: 2 ~ 30 Sekunden, maximal 5 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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Video Edit / Video Extend

Referenzaudio-URL-Array, optional; bei Angabe 1-5 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 5 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

Materialadressen: Öffentlich zugängliche HTTP(S)-URLs und für das gewählte Upstream-Konto zugängliche asset://-Material-IDs werden unterstützt.

Maximum array length: 5

Beispiel:

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

duration

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

Verfügbare Optionen:

-1

Beispiel:

8

quality

enum<string>

Standard:720p

Videoauflösung, Standard ist 720p

Verfügbare Werte:

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

Verfügbare Optionen:

480p,

720p

Beispiel:

"720p"

aspect_ratio

enum<string>

Standard:adaptive

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
16:9	854×480	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	480×854	720×1280
21:9	992×432	1470×630

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
16:9	854×480	1280×720
4:3	752×560	1112×834
1:1	640×640	960×960
3:4	560×752	834×1112
9:16	480×854	720×1280
21:9	992×432	1470×630

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

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

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

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

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-flash-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 Flash Vollständige Parameterreferenz

Text-to-Video

Image-to-Video

Reference-to-Video

Video Edit

Video Extend

Autorisierungen

Body

Antwort