Zum Inhalt springen
Kostenlos registrieren
Wan

Wan Video-API: Generierung aus Text, Bildern, Referenzen und Bearbeitung

Binde Wan 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 und vorhandene Videos bearbeiten. 3.0 und Prime unterstützen drei Generierungsoperationen. Wähle bei 2.7 die passende Model ID für Generierung aus Text, Bildern oder Referenzen beziehungsweise Bearbeitung.

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 IDOperationDauer (Sekunden)AusgabestufeSeitenverhältnisAudioMedienrolle
wan2.7-i2vimage_to_video2–15, Schrittweite 1720p, 1080pNicht angebenprovider_defaultfirst_frame, last_frame, driving_audio
wan2.7-r2vreference_to_video2–15, Schrittweite 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultreference_image, reference_video
wan2.7-t2vtext_to_video2–15, Schrittweite 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultdriving_audio
wan2.7-videoeditvideo_edit2–15, Schrittweite 1; auto verfügbar720p, 1080pNicht angebenprovider_defaultbase_video
wan3.0-video-primeimage_to_video2–30, Schrittweite 1; auto verfügbar480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offfirst_frame, last_frame
wan3.0-video-primereference_to_video2–30, Schrittweite 1; auto verfügbar480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offreference_image, reference_video, reference_audio
wan3.0-video-primetext_to_video2–30, Schrittweite 1; auto verfügbar480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offKeine
wan3.0-videoimage_to_video2–30, Schrittweite 1; auto verfügbar480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offfirst_frame, last_frame
wan3.0-videoreference_to_video2–30, Schrittweite 1; auto verfügbar480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offreference_image, reference_video, reference_audio
wan3.0-videotext_to_video2–30, Schrittweite 1; auto verfügbar480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offKeine

Bei Image-to-Video (wan2.7-i2v sowie wan3.0-video / wan3.0-video-prime mit adaptive) und Reference-to-Video mit adaptive übernimmt das Ergebnis das Seitenverhältnis des Eingabebilds; die Ausgabestufe bestimmt die Gesamtpixelzahl, nicht feste Abmessungen. Mit dem quadratischen Beispielbild dieser Seite lieferte 720p in unseren Tests 960×960 und 480p 640×640. Für ein festes Quer- oder Hochformat setzen Sie output.aspect_ratio explizit (wan2.7-i2v akzeptiert dieses Feld nicht; verwenden Sie ein Eingabebild im gewünschten Verhältnis).

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.

Referenzbild für die Videogenerierung: blauer Keramikbecher auf einem weißen Tisch

Das Bearbeitungsbeispiel verwendet ein Video eines Jungen auf einem Stadtplatz, etwa 5,04 Sekunden, 1280 × 720 und 24 fps. Es wird als base_video übergeben, nicht als Referenzbild.

Video aus Text generieren

wan2.7-t2v

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinprovider_defaultprovider_default
duration.modestringNeinfixedfixed
duration.secondsintegerNein2–15, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNein16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringNeinmp4mp4
output.resolutionstringNein720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
driving_audioaudio, optional, höchstens 1wav, mp3Größe höchstens 15 MB; Dauer 2–30 Sekunden

Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.

Das optionale driving_audio ist steuerndes Audio und verwendet type="audio". Es ist eine andere Medienrolle als reference_audio bei der Referenzgenerierung.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch 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": "wan2.7-t2v",
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
count / media_roleRollen 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.

wan3.0-video-prime

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinon, offon
duration.modestringNeinfixed, autofixed
duration.secondsintegerNein2–30, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNeinadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNeinmp4mp4
output.resolutionstringNein480p, 720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

Diese Operation akzeptiert keine Medien.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Sende bei duration.mode="auto" kein duration.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": "wan3.0-video-prime",
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.

wan3.0-video

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinon, offon
duration.modestringNeinfixed, autofixed
duration.secondsintegerNein2–30, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNeinadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNeinmp4mp4
output.resolutionstringNein480p, 720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

Diese Operation akzeptiert keine Medien.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Sende bei duration.mode="auto" kein duration.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": "wan3.0-video",
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.

Video aus Bildern generieren

wan2.7-i2v

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinprovider_defaultprovider_default
duration.modestringNeinfixedfixed
duration.secondsintegerNein2–15, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.formatstringNeinmp4mp4
output.resolutionstringNein720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
first_frameimage, genau 1 (erforderlich)jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px
last_frameimage, optional, höchstens 1jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px
driving_audioaudio, optional, höchstens 1wav, mp3Größe höchstens 15 MB; Dauer 2–30 Sekunden

Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.

Das optionale driving_audio ist steuerndes Audio und verwendet type="audio". Es ist eine andere Medienrolle als reference_audio bei der Referenzgenerierung.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • first_frame ist 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": "wan2.7-i2v",
"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"
},
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
count / media_roleRollen 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.

wan3.0-video-prime

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinon, offon
duration.modestringNeinfixed, autofixed
duration.secondsintegerNein2–30, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNeinadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNeinmp4mp4
output.resolutionstringNein480p, 720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
first_frameimage, genau 1 (erforderlich)jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px
last_frameimage, optional, höchstens 1jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px

Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Sende bei duration.mode="auto" kein duration.seconds.
  • Gib mindestens eine der Rollen first_frame, last_frame 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": "wan3.0-video-prime",
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.
count / media_roleRollen 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.

wan3.0-video

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinon, offon
duration.modestringNeinfixed, autofixed
duration.secondsintegerNein2–30, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNeinadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNeinmp4mp4
output.resolutionstringNein480p, 720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
first_frameimage, genau 1 (erforderlich)jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px
last_frameimage, optional, höchstens 1jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px

Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Sende bei duration.mode="auto" kein duration.seconds.
  • Gib mindestens eine der Rollen first_frame, last_frame 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": "wan3.0-video",
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.
count / media_roleRollen 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

wan2.7-r2v

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinprovider_defaultprovider_default
duration.modestringNeinfixedfixed
duration.secondsintegerNein2–15, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNein16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringNeinmp4mp4
output.resolutionstringNein720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
reference_imageimage, optional, höchstens 10jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px
reference_videovideo, optional, höchstens 5mp4, movGröße höchstens 100 MB; Breite 240–4096 px; Höhe 240–4096 px; Dauer 1–15 Sekunden; Bildrate mindestens 16 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden

Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Gib mindestens eine der Rollen reference_image, reference_video 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": "wan2.7-r2v",
"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": "16:9"
},
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
count / media_roleRollen 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.

wan3.0-video-prime

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinon, offon
duration.modestringNeinfixed, autofixed
duration.secondsintegerNein2–30, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNeinadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNeinmp4mp4
output.resolutionstringNein480p, 720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
reference_imageimage, optional, höchstens 10jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px
reference_videovideo, optional, höchstens 5mp4, movGröße höchstens 100 MB; Breite 240–4096 px; Höhe 240–4096 px; Dauer 1–15 Sekunden; Bildrate mindestens 16 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden
reference_audioaudio, optional, höchstens 5wav, mp3Größe höchstens 15 MB; Dauer 1–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" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Sende bei duration.mode="auto" kein duration.seconds.
  • Gib mindestens eine der Rollen reference_image, reference_video, reference_audio an.
  • Bei Referenzvideos darf die Summe aus Gesamtdauer der Eingabevideos und Ausgabedauer 30 Sekunden nicht überschreiten. Auch bei automatischer Dauer begrenzt dieses Restbudget die Ausgabe.

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": "wan3.0-video-prime",
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.
sum_lteGesamtdauer der Referenzvideos oder Ausgabedauer so kürzen, dass die Summe höchstens 30 Sekunden beträgt.
count / media_roleRollen 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.

wan3.0-video

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.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinon, offon
duration.modestringNeinfixed, autofixed
duration.secondsintegerNein2–30, Schrittweite 1 Sekunde; nur bei fester Dauer5
output.aspect_ratiostringNeinadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringNeinmp4mp4
output.resolutionstringNein480p, 720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
reference_imageimage, optional, höchstens 10jpeg, jpg, png, bmp, webpGröße höchstens 20 MB; Breite 240–8000 px; Höhe 240–8000 px
reference_videovideo, optional, höchstens 5mp4, movGröße höchstens 100 MB; Breite 240–4096 px; Höhe 240–4096 px; Dauer 1–15 Sekunden; Bildrate mindestens 16 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden
reference_audioaudio, optional, höchstens 5wav, mp3Größe höchstens 15 MB; Dauer 1–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" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • Sende bei duration.mode="auto" kein duration.seconds.
  • Gib mindestens eine der Rollen reference_image, reference_video, reference_audio an.
  • Bei Referenzvideos darf die Summe aus Gesamtdauer der Eingabevideos und Ausgabedauer 30 Sekunden nicht überschreiten. Auch bei automatischer Dauer begrenzt dieses Restbudget die Ausgabe.

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": "wan3.0-video",
"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-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.
sum_lteGesamtdauer der Referenzvideos oder Ausgabedauer so kürzen, dass die Summe höchstens 30 Sekunden beträgt.
count / media_roleRollen 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 bearbeiten

wan2.7-videoedit

Verwende diese Operation, um das Bild eines vorhandenen Videos zu verändern. Bereite zuerst ein Quellvideo vor, das die Anforderungen erfüllt.

Setze model auf die Model ID dieses Abschnitts und operation auf video_edit. Verwende nur die unten aufgeführten Generierungsfelder und lege Medien im Array media ab.

FeldTypErforderlichWerte oder BereichStandardwert
audio.modestringNeinprovider_defaultprovider_default
duration.modestringNeinfixed, autoauto
duration.secondsintegerNein2–15, Schrittweite 1 Sekunde; nur bei fester DauerKeine
output.formatstringNeinmp4mp4
output.resolutionstringNein720p, 1080p1080p
promptstringJaZeichenfolgeKeine
provider_options.alibaba.prompt_extendbooleanNeintrue / false; steuert die Prompt-Erweiterungtrue
seedintegerNein0–2147483647, Schrittweite 1; Zufallsstartwert, 0 erlaubtKeine
watermarkbooleanNeinfalse, truefalse

Medienanforderungen

MedienrolleTyp und AnzahlFormatGrenzen pro Datei
base_videovideo, genau 1 (erforderlich)mp4, movGröße höchstens 100 MB; Breite 240–4096 px; Höhe 240–4096 px; Dauer 1–15 Sekunden; Bildrate mindestens 16 fps; Gesamtdauer dieser Rolle höchstens 15 Sekunden

Ob Medien erforderlich sind, richtet sich zusätzlich nach den folgenden Kombinationsregeln.

Kombinationsregeln

  • Bei duration.mode="fixed" ist duration.seconds erforderlich. Gib bei explizitem fixed auch die Sekunden an.
  • base_video ist erforderlich.
  • Sende bei duration.mode="auto" kein duration.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": "wan2.7-videoedit",
"operation": "video_edit",
"prompt": "Keep the boy and his motion in the source video. Give the city plaza warmer evening lighting.",
"duration": {
"mode": "auto"
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "base",
"type": "video",
"role": "base_video",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4"
}
]
}

Häufige 422-Fehler

422-FehlercodeAbhilfe
enum / range / stepWerte und Schrittweite anhand der Feldtabelle dieses Abschnitts anpassen.
unsupported_fieldFelder entfernen, die nicht in der Feldtabelle dieser Operation stehen.
requiresSekunden, Seitenverhältnis, Audioeinstellungen oder Medien gemäß den Kombinationsregeln dieses Abschnitts ergänzen.
excludesFelder entfernen, die mit automatischer Dauer oder Endbild kollidieren.
count / media_roleRollen 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.