Seedance Video-API: Modelle, Felder und Medienanforderungen
Binde Seedance mit deinem BetterToken API Key ein und wähle Felder, Medien und Generierungsart anhand von Model ID und Operation.
Du kannst Videos aus Text, einem Startbild oder Referenzmedien generieren. Die vier Modelle für China unterstützen drei Generierungsoperationen; die zwei SR-Modelle unterstützen Generierung aus Text und Generierung aus Bildern mit einem einzelnen Startbild. Wähle die Model ID nach Operation, Dauer und Ausgabestufe.
Halte deinen BetterToken API Key bereit. Die Base URL ist https://bettertoken.ai/v1; verwende Authorization: Bearer YOUR_API_KEY zur Authentifizierung. Kopiere die Model ID exakt, einschließlich Groß- und Kleinschreibung.
Alle folgenden request.json verwenden denselben Ablauf: Angebot einholen, bestätigen, Aufgabe erstellen, Status abfragen und herunterladen. Ein Angebot startet keine Generierung; die Erstellung übermittelt eine kostenpflichtige Aufgabe. Aktuelle Preise stehen in der model plaza.
Modelle und Operationen
Die folgende Tabelle zeigt die verfügbaren Werte je Operation. Standardwerte, Medienanzahl und Kombinationsregeln stehen im jeweiligen Abschnitt. Die Mediengrößen verwenden 1 MB = 1048576 Bytes.
| Model ID | Operation | Dauer (Sekunden) | Ausgabestufe | Seitenverhältnis | Audio | Medienrolle |
|---|---|---|---|---|---|---|
ByteDance-Seedance-2.0-SR | image_to_video | 5–10, Schrittweite 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.0-SR | text_to_video | 5–10, Schrittweite 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Keine |
ByteDance-Seedance-2.5-SR | image_to_video | 5–10, Schrittweite 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.5-SR | text_to_video | 5–10, Schrittweite 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Keine |
doubao-seedance-2-0-260128 | image_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-260128 | reference_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-260128 | text_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Keine |
doubao-seedance-2-0-fast-260128 | image_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-fast-260128 | reference_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-fast-260128 | text_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Keine |
doubao-seedance-2-0-mini-260615 | image_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-mini-260615 | reference_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-mini-260615 | text_to_video | 4–15, Schrittweite 1; auto verfügbar | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Keine |
doubao-seedance-2-5-260628 | image_to_video | 4–30, Schrittweite 1; auto verfügbar | 480p, 720p, 1080p | adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-5-260628 | reference_to_video | 4–30, Schrittweite 1; auto verfügbar | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-5-260628 | text_to_video | 4–30, Schrittweite 1; auto verfügbar | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Keine |
Die beiden SR-Modelle erlauben nur feste Dauern von 5 oder 10 Sekunden. Die Modelle für China und die SR-Modelle haben unterschiedliche Model IDs. Übertrage Felder und Mediengrenzen eines Modells nicht auf ein anderes.
Beispielmedien
Die Beispiele für Generierung aus Bildern und Bildreferenzen verwenden einen blauen Keramikbecher auf einem weißen Tisch. Du kannst das Beispielbild ausprobieren oder es vorher durch eigene öffentlich erreichbare HTTPS-Medien ersetzen, die du verwenden darfst und die die Anforderungen dieser Seite erfüllen.

Video aus Text generieren
ByteDance-Seedance-2.0-SR
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 5–10, Schrittweite 5 Sekunden; nur bei fester Dauer | 5 |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 720p, 1080p, 4k | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
ByteDance-Seedance-2.5-SR
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 5–10, Schrittweite 5 Sekunden; nur bei fester Dauer | 5 |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 720p, 1080p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
doubao-seedance-2-0-260128
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
doubao-seedance-2-0-fast-260128
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
doubao-seedance-2-0-mini-260615
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
doubao-seedance-2-5-260628
Verwende diese Operation, wenn du ein Video nur aus einer Textbeschreibung generieren möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf text_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | auto |
duration.seconds | integer | Nein | 4–30, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p, 1080p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
Diese Operation akzeptiert keine Medien.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-5-260628", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
Video aus Bildern generieren
ByteDance-Seedance-2.0-SR
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 5–10, Schrittweite 5 Sekunden; nur bei fester Dauer | 5 |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 720p, 1080p, 4k | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, genau 1 (erforderlich) | jpeg, png, webp | Größe höchstens 10 MB; Breite 128–4096 px; Höhe 128–4096 px |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. first_frameist erforderlich.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
ByteDance-Seedance-2.5-SR
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed | fixed |
duration.seconds | integer | Nein | 5–10, Schrittweite 5 Sekunden; nur bei fester Dauer | 5 |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 720p, 1080p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, genau 1 (erforderlich) | jpeg, png, webp | Größe höchstens 10 MB; Breite 128–4096 px; Höhe 128–4096 px |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. first_frameist erforderlich.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
doubao-seedance-2-0-260128
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, genau 1 (erforderlich) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
last_frame | image, optional, höchstens 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. first_frameist erforderlich.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
doubao-seedance-2-0-fast-260128
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, genau 1 (erforderlich) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
last_frame | image, optional, höchstens 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. first_frameist erforderlich.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
doubao-seedance-2-0-mini-260615
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, genau 1 (erforderlich) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
last_frame | image, optional, höchstens 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. first_frameist erforderlich.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
doubao-seedance-2-5-260628
Verwende diese Operation, wenn du das Startbild oder Start- und Endbild durch Bilder festlegen möchtest.
Setze model auf die Model ID dieses Abschnitts und operation auf image_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | auto |
duration.seconds | integer | Nein | 4–30, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p, 1080p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
first_frame | image, genau 1 (erforderlich) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
last_frame | image, optional, höchstens 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. first_frameist erforderlich.- Diese Operation erfordert
output.aspect_ratio="adaptive", sowohl bei einem einzelnen Startbild als auch bei Start- und Endbild.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-5-260628", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
Video aus Referenzen generieren
doubao-seedance-2-0-260128
Verwende diese Operation, wenn Referenzmedien die Merkmale eines Motivs oder einer Bewegung erhalten sollen.
Setze model auf die Model ID dieses Abschnitts und operation auf reference_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
reference_image | image, optional, höchstens 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
reference_video | video, optional, höchstens 3 | mp4, mov | Größe höchstens 200 MB; Breite 300–6000 px; Höhe 300–6000 px; Dauer 2–15 Sekunden; Bildrate mindestens 24 fps, höchstens 60 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
reference_audio | audio, optional, höchstens 3 | wav, mp3 | Größe höchstens 15 MB; Dauer 2–15 Sekunden; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. - Gib mindestens eine der Rollen
reference_image,reference_video,reference_audioan. - Referenzaudio lässt sich nicht allein verwenden. Gib zusätzlich ein Referenzbild oder Referenzvideo an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
doubao-seedance-2-0-fast-260128
Verwende diese Operation, wenn Referenzmedien die Merkmale eines Motivs oder einer Bewegung erhalten sollen.
Setze model auf die Model ID dieses Abschnitts und operation auf reference_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
reference_image | image, optional, höchstens 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
reference_video | video, optional, höchstens 3 | mp4, mov | Größe höchstens 200 MB; Breite 300–6000 px; Höhe 300–6000 px; Dauer 2–15 Sekunden; Bildrate mindestens 24 fps, höchstens 60 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
reference_audio | audio, optional, höchstens 3 | wav, mp3 | Größe höchstens 15 MB; Dauer 2–15 Sekunden; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. - Gib mindestens eine der Rollen
reference_image,reference_video,reference_audioan. - Referenzaudio lässt sich nicht allein verwenden. Gib zusätzlich ein Referenzbild oder Referenzvideo an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
doubao-seedance-2-0-mini-260615
Verwende diese Operation, wenn Referenzmedien die Merkmale eines Motivs oder einer Bewegung erhalten sollen.
Setze model auf die Model ID dieses Abschnitts und operation auf reference_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | fixed |
duration.seconds | integer | Nein | 4–15, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
reference_image | image, optional, höchstens 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
reference_video | video, optional, höchstens 3 | mp4, mov | Größe höchstens 200 MB; Breite 300–6000 px; Höhe 300–6000 px; Dauer 2–15 Sekunden; Bildrate mindestens 24 fps, höchstens 60 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
reference_audio | audio, optional, höchstens 3 | wav, mp3 | Größe höchstens 15 MB; Dauer 2–15 Sekunden; Gesamtdauer dieser Rolle höchstens 15 Sekunden |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. - Gib mindestens eine der Rollen
reference_image,reference_video,reference_audioan. - Referenzaudio lässt sich nicht allein verwenden. Gib zusätzlich ein Referenzbild oder Referenzvideo an.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
doubao-seedance-2-5-260628
Verwende diese Operation, wenn Referenzmedien die Merkmale eines Motivs oder einer Bewegung erhalten sollen.
Setze model auf die Model ID dieses Abschnitts und operation auf reference_to_video. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.
| Feld | Typ | Erforderlich | Werte oder Bereich | Standardwert |
|---|---|---|---|---|
audio.mode | string | Nein | on, off | on |
duration.mode | string | Nein | fixed, auto | auto |
duration.seconds | integer | Nein | 4–30, Schrittweite 1 Sekunde; nur bei fester Dauer | Keine |
output.aspect_ratio | string | Nein | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | Nein | mp4 | mp4 |
output.resolution | string | Nein | 480p, 720p, 1080p | 720p |
prompt | string | Ja | Zeichenfolge | Keine |
watermark | boolean | Nein | false, true | false |
Medienanforderungen
| Medienrolle | Typ und Anzahl | Format | Grenzen pro Datei |
|---|---|---|---|
reference_image | image, optional, höchstens 30 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Größe 1–31457279 Bytes; Breite 300–6000 px; Höhe 300–6000 px |
reference_video | video, optional, höchstens 10 | mp4, mov | Größe höchstens 200 MB; Breite 300–6000 px; Höhe 300–6000 px; Dauer 2–30 Sekunden; Bildrate mindestens 24 fps, höchstens 60 fps; Gesamtdauer dieser Rolle höchstens 30 Sekunden |
reference_audio | audio, optional, höchstens 10 | wav, mp3 | Größe höchstens 15 MB; Dauer 2–30 Sekunden; Gesamtdauer dieser Rolle höchstens 30 Sekunden |
Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.
Kombinationsregeln
- Bei
duration.mode="fixed"istduration.secondserforderlich. Gib bei explizitemfixedauch die Sekunden an. - Sende bei
duration.mode="auto"keinduration.seconds. - Gib mindestens eine der Rollen
reference_image,reference_video,reference_audioan.
Beispielanfrage
Speichere das folgende JSON als request.json. Hole nach dem allgemeinen Ablauf zuerst ein Angebot ein und erstelle die Aufgabe nach der Bestätigung.
{ "model": "doubao-seedance-2-5-260628", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Häufige 422-Fehler
| 422-Fehlercode | Abhilfe |
|---|---|
enum / range / step | Werte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen. |
unsupported_field | Felder entfernen, die nicht in der Feldtabelle dieser Operation stehen. |
requires | Sekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen. |
excludes | Felder entfernen, die mit automatischer Dauer oder Endbild kollidieren. |
count / media_role | Rollen und Anzahl anhand der Medientabelle dieses Abschnitts anpassen. |
video_input_unsupported | Öffentliche HTTPS-URL, Content-Type und Dateiformat prüfen und ein neues Angebot einholen. |
Offizielle Dokumentation
Verwende beim Aufruf von BetterToken die Felder dieser Seite und die passende Operation im aktuellen Modellkatalog.

