> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-video-edit) / [Video Extend](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/task-management/get-task-detail). 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 ## OpenAPI ````yaml de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Seedance 2.5 Vollständige Parameterreferenz description: >- Gemeinsame Parameterreferenz für die 6 Modelle in diesem Seedance 2.5-Ordner. Der Modus wird mit model gewählt; Pflichtfelder und Grenzen stehen unten. license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] tags: - name: Videogenerierung description: API-Schnittstellen für KI-Videogenerierung paths: /v1/videos/generations: post: tags: - Videogenerierung summary: Seedance 2.5 Vollständige Parameterreferenz description: >+ 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-video-edit) / [Video Extend](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/video-series/seedance/seedance-2.5/seedance-2.5-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](/de/api-manual/task-management/get-task-detail) - 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](/de/api-manual/task-management/get-task-detail). 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 operationId: createSeedance25VideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video_basic: summary: Einfaches Text-to-Video value: 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 text_to_video_web_search: summary: Text-to-Video mit Websuche value: model: seedance-2.5-text-to-video prompt: >- Today's New York weather forecast, with city skyline animation and temperature overlay display duration: 8 quality: 720p aspect_ratio: '16:9' model_params: web_search: true text_to_video_draft: summary: Entwurfsmodus (480p) value: model: seedance-2.5-text-to-video prompt: >- Eine Makrokamera fokussiert einen grünen Glasfrosch auf einem Blatt. Der Fokus wandert langsam von seiner glatten Haut zu seinem vollständig durchsichtigen Bauch, in dem ein leuchtend rotes Herz kräftig und rhythmisch schlägt. duration: 8 quality: 480p aspect_ratio: '16:9' generate_audio: true content_filter: true draft: true image_to_video_first_frame: summary: Startbild-Video value: model: seedance-2.5-image-to-video prompt: >- The camera slowly zooms in, the scene gradually comes to life image_urls: - https://example.com/first-frame.jpg duration: 5 quality: 720p aspect_ratio: adaptive image_to_video_first_last_frame: summary: Start-/Endbild-Video value: model: seedance-2.5-image-to-video prompt: A smooth transition between two scenes image_urls: - https://example.com/first.jpg - https://example.com/last.jpg duration: 6 quality: 720p aspect_ratio: adaptive image_to_video_draft: summary: Entwurfsmodus (480p) value: model: seedance-2.5-image-to-video prompt: >- Die Kamera zoomt langsam heran, die Szene erwacht allmählich zum Leben image_urls: - https://example.com/first-frame.jpg duration: 5 quality: 480p aspect_ratio: adaptive draft: true reference_to_video_multimodal: summary: Multimodale Referenz (Bild + Video + Audio) value: model: seedance-2.5-reference-to-video prompt: >- Use the first-person perspective framing of @video1 throughout, and use @audio1 as background music throughout. First-person perspective fruit tea promotional video... image_urls: - https://example.com/ref1.jpg - https://example.com/ref2.jpg video_urls: - https://example.com/reference.mp4 audio_urls: - https://example.com/bgm.mp3 duration: 10 quality: 720p aspect_ratio: '16:9' generate_audio: true content_filter: true reference_to_video_subject_reference: summary: Bild- + Videoreferenz (Motiv + Kameraführung) value: model: seedance-2.5-reference-to-video prompt: >- Make the face cream in @image1 the hero product, and follow the camera rhythm and lighting mood of @video1 to generate a clean product commercial image_urls: - https://example.com/cream.jpg video_urls: - https://example.com/reference.mp4 duration: 5 quality: 720p aspect_ratio: '16:9' reference_to_video_multi_video: summary: Mehrere Videoreferenzen (mehrteilige Erzählung) value: model: seedance-2.5-reference-to-video prompt: >- The arched window in @video1 opens into the art gallery interior, continuing with @video2; then the camera enters the painting, continuing with @video3 video_urls: - https://example.com/part1.mp4 - https://example.com/part2.mp4 - https://example.com/part3.mp4 duration: 8 quality: 720p aspect_ratio: '16:9' generate_audio: true content_filter: true reference_to_video_draft: summary: Entwurfsmodus (480p) value: model: seedance-2.5-reference-to-video prompt: >- Verwende durchgehend den Bildaufbau aus der Ich-Perspektive von @video1 und @audio1 als Hintergrundmusik. Ein Werbevideo für Früchtetee aus der Ich-Perspektive... image_urls: - https://example.com/ref1.jpg - https://example.com/ref2.jpg video_urls: - https://example.com/reference.mp4 audio_urls: - https://example.com/bgm.mp3 duration: 10 quality: 480p aspect_ratio: '16:9' generate_audio: true content_filter: true draft: true video_edit_remove_objects: summary: Video bearbeiten (Objekte entfernen) value: model: seedance-2.5-video-edit prompt: >- Video bearbeiten: alle Passanten in @video1 entfernen, nur die Hauptfigur behalten video_urls: - https://example.com/original.mp4 quality: 720p generate_audio: true content_filter: true video_edit_replace_subject: summary: Video bearbeiten (Element per Bildreferenz ersetzen) value: model: seedance-2.5-video-edit prompt: >- Video bearbeiten: das Parfüm in der Geschenkbox in @video1 durch die Gesichtscreme aus @image1 ersetzen, Kamerafahrt unverändert lassen image_urls: - https://example.com/cream.jpg video_urls: - https://example.com/original.mp4 duration: -1 quality: 720p video_edit_draft: summary: Entwurfsmodus (480p) value: model: seedance-2.5-video-edit prompt: >- Video bearbeiten: alle Passanten in @video1 entfernen, nur die Hauptfigur behalten video_urls: - https://example.com/original.mp4 quality: 480p generate_audio: true content_filter: true draft: true video_extend_extend_backward: summary: Video nach hinten verlängern (eigene Dauer) value: model: seedance-2.5-video-extend prompt: >- @video1 nach hinten verlängern: die Figur läuft aus dem Bild, die Kamera fährt langsam zurück und gibt die leere Straße frei video_urls: - https://example.com/original.mp4 duration: 12 quality: 720p generate_audio: true content_filter: true video_extend_extend_forward: summary: Video nach vorne verlängern (automatische Dauer) value: model: seedance-2.5-video-extend prompt: >- @video1 nach vorne verlängern: die Figur geht weiter in den Sonnenuntergang, während das Licht allmählich schwindet video_urls: - https://example.com/original.mp4 duration: -1 quality: 720p video_extend_draft: summary: Entwurfsmodus (480p) value: model: seedance-2.5-video-extend prompt: >- @video1 nach hinten verlängern: die Figur läuft aus dem Bild, die Kamera fährt langsam zurück und gibt die leere Straße frei video_urls: - https://example.com/original.mp4 duration: 12 quality: 480p generate_audio: true content_filter: true draft: true draft_to_video_basic: summary: In ein finales 1080p-Video umwandeln (MP4) value: model: seedance-2.5-draft-to-video source_task_id: task-unified-1774857405-abc123 draft_to_video_mov: summary: In ein finales 1080p-Video umwandeln (MOV) value: model: seedance-2.5-draft-to-video source_task_id: task-unified-1774857405-abc123 output_format: mov responses: '200': description: Videogenerierungsaufgabe erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_parameter message: Invalid request parameters type: invalid_request_error '401': description: Nicht authentifiziert, Token ungültig oder abgelaufen content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Guthaben, Aufladung erforderlich content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Zugriff verweigert content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: seedance-2.5-text-to-video type: invalid_request_error '429': description: Anfragelimit überschritten content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '503': description: >- Dienst vorübergehend nicht verfügbar; bei nicht verfügbarem Entwurfsmodus kann draft_unavailable zurückgegeben werden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: draft_unavailable: summary: Entwurfsmodus vorübergehend nicht verfügbar value: 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 components: schemas: VideoGenerationRequest: type: object description: >- 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. required: - model properties: model: type: string description: >- 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` | enum: - 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 example: seedance-2.5-text-to-video prompt: type: string description: >- 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** 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 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 example: >- 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: type: string description: >- 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:** 1. Die Aufgabe muss zum aktuellen Konto gehören 2. Die Aufgabe muss eines der fünf Seedance-2.5-Generierungsmodelle verwenden 3. Die Aufgabe muss mit `draft: true` erstellt worden sein 4. Der Aufgabenstatus muss `completed` sein 5. Die aktuelle Zeit muss vor `draft_expires_at` aus der Aufgabenabfrage liegen example: task-unified-1774857405-abc123 image_urls: type: array description: >- 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 items: type: string format: uri minItems: 1 maxItems: 30 example: - https://example.com/first-frame.jpg video_urls: type: array description: >- 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 items: type: string format: uri minItems: 1 maxItems: 10 example: - https://example.com/reference.mp4 audio_urls: type: array description: >- 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 items: type: string format: uri minItems: 1 maxItems: 10 example: - https://example.com/bgm.mp3 duration: type: integer description: >- 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 example: 8 quality: type: string description: >- 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 enum: - 480p - 720p - 1080p default: 720p example: 720p draft: type: boolean description: >- 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](/de/api-manual/task-management/get-task-detail) das Feld `draft_expires_at` - Übergeben Sie vor diesem Zeitpunkt die Aufgaben-ID des Entwurfs an [Seedance 2.5 Draft-to-Video](/de/api-manual/video-series/seedance/seedance-2.5/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 default: false example: false aspect_ratio: type: string description: >- 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 enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' - '21:9' - adaptive default: adaptive example: '16:9' generate_audio: type: boolean description: >- 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 default: true example: true content_filter: type: boolean description: >- 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 default: true example: true output_format: type: string description: >- **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 enum: - mp4 - mov default: mp4 example: mp4 model_params: type: object description: |- Gilt nur für: **Text-to-Video** Erweiterte Modellparameter properties: web_search: type: boolean description: >- Websuche, Standard ist `false` **Hinweise:** - Nach der Aktivierung entscheidet das Modell eigenständig anhand des Prompts, ob Internetinhalte durchsucht werden sollen (z.B. Produkte, Wetter usw.), um die Aktualität zu verbessern - Erhöht die Latenz geringfügig - Kosten fallen nur an, wenn die Suche tatsächlich ausgelöst wird; nach der Aktivierung können mehrere Aufrufe erfolgen **Nicht mit dem Inhaltsfilter kombinierbar:** - Behalten Sie `content_filter: true` bei, wenn die Websuche aktiviert ist; die Kombination mit `content_filter: false` gibt einen 400-Parameterfehler zurück default: false example: false callback_url: type: string description: >- 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 format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1761313744 id: type: string description: Aufgaben-ID example: task-unified-1774857405-abc123 model: type: string description: Tatsächlich verwendeter Modellname example: seedance-2.5-text-to-video object: type: string enum: - video.generation.task description: Spezifischer Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Detaillierte Informationen zur Videoaufgabe type: type: string enum: - text - image - audio - video description: Ausgabetyp der Aufgabe example: video usage: $ref: '#/components/schemas/VideoUsage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercode-Bezeichner message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp VideoTaskInfo: type: object properties: can_cancel: type: boolean description: >- Gibt an, ob die Aufgabe abgebrochen werden kann. Seedance 2.5 unterstützt keinen Abbruch durch Benutzer; dieses Feld gibt immer `false` zurück. example: false estimated_time: type: integer description: Geschätzte Fertigstellungszeit (Sekunden) minimum: 0 example: 165 video_duration: type: integer description: Videodauer (Sekunden) example: 8 VideoUsage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Geschätzter Credit-Verbrauch minimum: 0 example: 50 user_group: type: string description: Benutzergruppenkategorie example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle Schnittstellen erfordern eine Authentifizierung mit Bearer Token## **API Key erhalten:** Besuchen Sie die [API-Key-Verwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API Key zu erhalten **Fügen Sie ihn im Anfrage-Header hinzu:** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.