/image/generate erstellte Bilder und der Clip, den Reference-to-Video daraus gemacht hat. Die Töpferin behält ihr Haar, ihre Sommersprossen und ihre Schürze, die Teekanne behält ihre Glasur und ihren goldenen Henkel, und der Satz am Ende wird vor der Kamera gesprochen.

VENICE_API_KEY gesetzt ist:
Modell auswählen
Jede Stufe hat dieselben drei Varianten:
Prime ist die schnellere Option zu einem höheren Preis: Der Töpferei-Clip dauerte auf Standard 205 Sekunden und auf Prime 131. Jede ID gibt es auch in einer Schreibweise mit Punkt, etwa
wan-3.0-reference-to-video.
Image-to-Video und Reference-to-Video nehmen beide Bilder entgegen, aber für unterschiedliche Aufgaben. Image-to-Video beginnt exakt mit image_url und endet, wenn Sie end_image_url mitsenden, mit diesem Bild. Reference-to-Video behandelt Bilder als Referenzen: Was darauf zu sehen ist, erscheint im Clip, so ins Bild gesetzt, wie es der Prompt vorgibt. Verwenden Sie Image-to-Video, wenn die erste Einstellung feststeht, und Reference-to-Video, wenn Sie dieselbe Person oder dasselbe Produkt über mehrere Einstellungen hinweg brauchen.
Dauern, Seitenverhältnisse und Auflösungen stammen aus /models. Diese Abfrage liefert sie:
2s, 5s, 10s, 15s, 20s, 25s und 30s, die Seitenverhältnisse 16:9, 9:16, 1:1, 4:3 und 3:4 sowie Prompts mit bis zu 20.000 Zeichen. Image-to-Video und Reference-to-Video ergänzen adaptive, das sich an der Form Ihrer Eingabe orientiert. Diese Details können sich ändern, lesen Sie sie daher aus der API aus. Die Referenzlimits stehen nicht in /models, sondern in Schritt 2.
1. Preisangebot einholen
Abgerechnet wird pro Sekunde Ausgabe, zu einem Satz, der von Stufe und Auflösung abhängt. Am 23. Oktober 2026 kostete Standard $0.065 pro Sekunde bei 480p, $0.13 bei 720p und $0.26 bei 1080p, und Prime kostete $0.088, $0.182 und $0.364. Pro kostete $0.237 bei 1080p, $0.272 bei 2K und $0.296 bei 4K, und Prime Pro kostete $0.331, $0.355 und $0.379. Die drei Varianten einer Stufe kosten gleich viel, und das Abschalten vonaudio ändert den Preis nicht.
Referenzvideos werden zusätzlich abgerechnet, zum Satz des Jobs und auf Sekundenbruchteile genau, sodass ein 4,2-Sekunden-Clip 4,2 Sekunden hinzufügt. Referenzbilder und -audio sind kostenlos. Quote benötigt keinen API-Schlüssel; fügen Sie reference_video_total_duration in Sekunden hinzu, wenn der Job Referenzvideos enthält:
2. Job in die Warteschlange stellen
Dies ist die Anfrage hinter dem Töpferei-Clip, wobei die beiden Bilder auf die Kopien in dieser Dokumentation verweisen, sodass Sie sie unverändert ausführen können:
Die Referenzvideos und
duration müssen zusammen außerdem in 30 Sekunden passen. Videos können MP4 oder MOV sein, Audio MP3 oder WAV. Bilder, deren kurze Seite unter dem Minimum von 240 Pixeln liegt, werden hochskaliert statt abgelehnt.
Im Prompt ist @Image1 der erste Eintrag in reference_image_urls, @Image2 der zweite und so weiter, und @Video1 und @Audio1 zählen auf dieselbe Weise in ihren eigenen Arrays. Benennen Sie jede Referenz, die Sie senden, auch Audio: Schreiben Sie @Audio1 dorthin, wo die Stimme oder der Ton hingehört.
Wan 3.0 verwendet reference_document_urls nicht, obwohl die API-Referenz das Feld aufführt. Prime, Pro und Prime Pro lehnen es ab, und die Standardstufe akzeptiert das Dokument, ignoriert es und rechnet den Job wie gewohnt ab.
Die Antwort liefert Ihnen das Handle für alle weiteren Schritte:
queue_id haben, pollen Sie damit. Wenn die Antwort nie angekommen ist, kann ein erneutes Senden des Jobs zu einer doppelten Abbuchung führen. Queue ist auf 40 Anfragen pro Minute begrenzt und Retrieve auf 120; beide melden x-ratelimit-remaining-requests.
Die meisten Fehler werden hier mit 400 und ohne Abbuchung abgelehnt: ein Wert, der nicht in /models steht, ein Feld, das die Variante nicht akzeptiert, zu viele Referenzen, Audio ohne Bild oder Video oder ein fehlendes aspect_ratio. Der Body nennt das Problem in issues[].message. Clip-Längen werden erst nach der Abbuchung geprüft, sodass ein zu langer oder zu kurzer Referenzclip hier eine queue_id erhält und beim ersten Retrieve fehlschlägt, wobei die Abbuchung erstattet wird.
3. Pollen und herunterladen
Rufen Sie Retrieve mit den Werten aus der Queue-Antwort auf:video/mp4, und der Body ist das Video. Verzweigen Sie anhand von Content-Type.
Die beiden Zahlen sind Millisekunden: wie lange Jobs auf diesem Modell üblicherweise dauern und wie lange Ihr Job bereits läuft. Der Durchschnitt lag bei jedem getesteten Modell bei etwa 7,5 Minuten, und jeder Job war schneller. Die Jobs dauerten 1 bis 5 Minuten: 2-Sekunden-Tests bei 480p etwas mehr als eine Minute und Jobs mit einem 5-Sekunden-Referenzvideo 3 bis 5 Minuten. Pollen Sie alle 10 bis 15 Sekunden, statt bis zum Durchschnittswert zu warten.
Die MP4 ist H.264 mit 30 Bildern pro Sekunde und Stereo-AAC-Audio oder ohne Audiospur, wenn Sie audio: false gesendet haben. 720p kommt in 1280×720 zurück und Standard-1080p in 1920×1080, Pro und Prime Pro lieferten für 1080p jedoch 1936×1088.
Wenn der Job fehlschlägt
Ein fehlgeschlagener Job bleibt fehlgeschlagen: Erneutes Pollen liefert denselben Status und Body. Jobs, die fehlschlagen, bevor die Generierung beginnt, etwa wegen eines Referenzclips außerhalb der Längenlimits oder eines Bildes, das Venice nicht dekodieren kann, werden innerhalb von Sekunden nach dem Einreihen erstattet. Ihre Bodys enthalten nurerror; die Fehlertabelle listet sie auf.
Aufräumen
Übergeben Siedelete_media_on_completion: true an Retrieve, und das gespeicherte Video wird im selben Aufruf gelöscht, der es zurückgibt. Jeder spätere Retrieve-Aufruf für diese ID liefert 404. Lassen Sie das Feld weg, wenn Sie das Video mehr als einmal herunterladen möchten.
Workflows
Der Töpferei-Clip ist der Motiv-Workflow: Bilder hinein, dieselben Personen und Objekte im Clip. Die folgenden Anfragen sind die übrigen Workflows, so wie wir sie ausgeführt haben, mit den Eingaben unter Platzhalter-URLs. Alle außer dem letzten verwenden Reference-to-Video, wobei der Prompt bestimmt, was das Modell mit einem Clip macht.Bewegung aus einem Clip
Ein Referenzvideo kann Kamerabewegung oder Bewegung liefern, ohne seinen Inhalt zu übernehmen. Hier bestimmte eine 5-sekündige Kreisfahrt um eine Statue, erstellt mitwan-3-0-text-to-video, die Kamerabewegung um die Töpferin:
Eine Stimme für den Dialog
Geben Sie im Prompt an, dass der Satz mit der Stimme aus@Audio1 gesprochen wird. Hier lieferte ein 6-sekündiger Satz von /audio/speech die Stimme:
Einen Clip bearbeiten
Beschreiben Sie die Änderung, benennen Sie, was gleich bleiben muss, und setzen Sieduration auf die Länge des Clips:
adaptive kam die 854×480-Quelle in 1280×718 zurück.
Einen Clip verlängern
Das Ergebnis beginnt mit Ihrem Clip, neu generiert, und setzt ihn von dort aus fort.duration ist daher die Länge des gesamten Ergebnisses: der Clip plus das neue Material.
"duration": "5s" lieferte nur die Kreisfahrt und nichts weiter. Der Anfang wird neu generiert statt kopiert. Wenn Sie also Ihre Original-Frames benötigen, schneiden Sie das neue Material am Ende ab und fügen Sie es an Ihren Clip an. Die Sekunden des Clips werden doppelt abgerechnet, als Referenzvideo und als Teil des Ergebnisses. Da sich Clip und duration das 30-Sekunden-Limit teilen, kann ein 10-Sekunden-Clip um höchstens 10 Sekunden wachsen.
Erster und letzter Frame
Dieser Workflow verwendet Image-to-Video. Senden Sie den Eröffnungsframe alsimage_url, den Schlussframe als end_image_url und beschreiben Sie, was dazwischen passiert. Beide Frames stammen von /image/generate, und der zweite wurde mit /image/edit aus dem ersten erstellt, damit der Raum übereinstimmt:
Prompts schreiben
Wan 3.0 folgt einem strukturierten Prompt genau, und diese Gewohnheiten haben sich in unseren Durchläufen bewährt:- Versehen Sie jeden Abschnitt des Clips mit einem Zeitstempel, etwa
0-4s:und4-10s:. Im Töpferei-Clip landen das Anheben und die Heranfahrt genau dort, wo der Prompt sie platziert hat. - Setzen Sie Dialoge in doppelte Anführungszeichen und geben Sie an, wann eine Figur schweigen soll. Sich selbst überlassen, füllte das Modell ruhige Momente mit kurzen Wörtern: Die erste Aufnahme des Töpferei-Clips fügte vor dem Satz “Okay.” hinzu. Die zweite Aufnahme, mit
She is silent.in der ersten Einstellung undsays only:vor dem Satz, enthielt nur ein leises “Mm.” - Benennen Sie Kamerabewegungen schlicht:
slow push-in,static camera,one slow orbit. - Beschreiben Sie den gewünschten Ton, einschließlich Raumklang und Atmosphäre. Wan 3.0 hat keinen Negativ-Prompt, schreiben Sie Ausschlüsse wie
no musicdaher direkt in den Prompt.
Vollständiges Beispiel
Dieses Skript hat den Töpferei-Clip erstellt: Es holt ein Angebot für den Job ein, stellt ihn mit den beiden Bildern als Data-URLs in die Warteschlange, pollt, bis die MP4 eintrifft, und speichert sie. Speichern Sie die Töpferin und die Teekanne daneben alswoman.webp und teapot.webp. Die Frist von 20 Minuten ist ein Vielfaches des längsten Jobs, den wir ausgeführt haben.
delete_media_on_completion daher weg, wenn Sie es erneut herunterladen möchten.