Wan 3.0 Video Prime API

Verwenden Sie wan3.0-video-prime über die asynchrone Video-API von APIMaster. Die aktuelle Integration bietet 480P / 720P / 1080P, 2–30 ganzzahlige Sekunden und ein Video pro Task. Parameter- und Integrationsprüfung: 2026-10-26.

Endpunkte und Authentifizierung

Vorgang	Methode und URL
Erstellen	POST https://apimaster.ai/v1/videos
Abfragen	GET https://apimaster.ai/v1/videos/{task_id}
Herunterladen	GET https://apimaster.ai/v1/videos/{task_id}/content

Verwenden Sie bei jeder Anfrage Authorization: Bearer YOUR_API_KEY und beim Erstellen einer Aufgabe Content-Type: application/json. Verwenden Sie einen APIMaster-API-Schlüssel, keinen Alibaba-Cloud-Schlüssel. APIMaster stellt den vorgelagerten asynchronen Header bereit; Sie benötigen X-DashScope-Async nicht.

Der kompatible Erstellungsendpunkt /videos/generations gibt eine andere Antwortstruktur zurück; die folgenden Beispiele verwenden durchgängig /videos.

Aktuelle Routenfähigkeiten

Derzeit bedienen zwei Integrationen dieses Modell: die native Route von Alibaba Cloud und die GMI-Route. Erweiterte Felder erfordern die entsprechende Route; das Übermitteln eines Felds wählt diese Route nicht aus. Bestätigen Sie, auf welche Route Ihr API-Schlüssel zugreifen kann, bevor Sie routenspezifische Beispiele verwenden.

Funktion	Alibaba Cloud nativ	GMI
Text-zu-Video, erstes Frame, erste/letzte Frames, Referenzbilder	Integriert	Integriert, mit unterschiedlichen Medienfeldern
Referenzaudio	metadata.input.media	audio_url
Dokument / öffentliche Webseite	Native Medienfelder werden weitergeleitet; nicht durch die Prüfung der abgeschlossenen Generierung abgedeckt	Nicht unterstützt
Referenzvideo, Bearbeitung, Erweiterung	Vor der Übermittlung blockiert	Nicht unterstützt
Automatische Dauer -1	Blockiert	Blockiert
Seitenverhältnis 21:9	Akzeptiert	Abgelehnt
Expliziter Audio-Schalter	generate_audio / audio	Nicht unterstützt; diese Felder weglassen
Prompt-Umschreibung deaktivieren / fester Seed 0	Die aktuelle Serialisierung erhält prompt_extend: false oder seed: 0 nicht; verlassen Sie sich nicht darauf	Explizite false und 0 bleiben erhalten

Ein stummes 5-Sekunden-720P-Video über die native Route wurde in der Abnahmeprüfung vom 2026-10-24 erfolgreich abgeschlossen, heruntergeladen und decodiert. Andere Medienkombinationen werden anhand des Adapters und des offiziellen Vertrags beschrieben und nicht als in der Generierung getestete Kombinationen dargestellt. Routenverfügbarkeit und Preise können sich ändern; siehe Modellkarte.

Vollständige gemeinsame Anfrageparameter

Senden Sie diese Felder auf oberster Ebene. Verwenden Sie für die breiteste Kompatibilität explizite duration, resolution und aspect_ratio, einen nicht leeren Prompt mit höchstens 5,000 Zeichen und lassen Sie routenspezifische Optionen weg.

Feld	Typ	Erforderlich / Standard	APIMaster-Verhalten
model	string	Erforderlich	Genau wan3.0-video-prime
prompt	string	Erforderlich auf beiden Routen	Nicht leer, einschließlich Bildgenerierung. GMI validiert 1–5,000 Zeichen; der native Adapter erfordert nicht leeren Text. Das offizielle native Limit beträgt 20,000; verlassen Sie sich routenübergreifend nicht auf dieses höhere Limit
duration	integer	5	2–30 Sekunden; kein -1, keine Bruchwerte und keine automatische Dauer
seconds	string	Optional	String-Alias, z. B. "5"; muss mit duration übereinstimmen, wenn beide angegeben werden
resolution	string	720P	480P, 720P, 1080P; Werte in Kleinbuchstaben auf oberster Ebene werden normalisiert. Dieser APIMaster-Standard weicht vom offiziellen nativen Standard ab
aspect_ratio	string	16:9	Übliche Werte: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4. 21:9 nur auf der nativen Route
ratio	string	Optional	Alias von aspect_ratio; verwenden Sie ein Feld und senden Sie keine widersprüchlichen Werte
size	string	Optional	Dimensionsalias wie 1280x720; es gilt routenspezifische Validierung. Bevorzugen Sie resolution und aspect_ratio. GMI erfordert, dass die kürzere Seite zur Auflösungsstufe passt; nativ werden nur die unterstützten Dimensionszuordnungen akzeptiert
input_reference	string	Optional	URL eines Bilds für das erste Frame. Verwenden Sie für routenübergreifende Kompatibilität eine öffentlich herunterladbare HTTP(S)-URL; kombinieren Sie sie nicht mit anderen Eingaben für das erste Frame
prompt_extend	boolean	Native true; GMI überlässt bei Auslassung den Anbieterstandard	Prompt-Umschreibung. Native kann sie derzeit mit false nicht zuverlässig deaktivieren; GMI leitet einen expliziten booleschen Wert weiter
watermark	boolean	Offizieller nativer Standard false; GMI überlässt bei Auslassung den Anbieterstandard	Wasserzeichen-Schalter
seed	integer	Zufällig, wenn ausgelassen	Portabler fester Bereich: 1–2147483647. Native akzeptiert zusätzlich -1 für zufällig; natives 0 wird bei der Serialisierung ausgelassen. GMI akzeptiert 0–2147483647 und lehnt -1 ab. Ein fester Seed garantiert keine identische Ausgabe

Die nativen Dimensionsaliase sind 832x480, 480x832, 1280x720, 720x1280, 1920x1080 und 1080x1920 für die üblichen Quer-/Hochformatfälle. Einige quadratische Dimensionszuordnungen werden auf 1:1 reduziert; andere zugeordnete Dimensionen können weiterhin die Seitenverhältnisvalidierung nicht bestehen. Verwenden Sie size nicht, um beliebige Dimensionen anzufordern.

Routenspezifische Parametertabellen

GMI-Felder

Dies sind Felder auf oberster Ebene zusätzlich zur gemeinsamen Tabelle. Der GMI-Adapter lehnt nicht erkannte Felder ab, einschließlich metadata, images, image_urls, audio, generate_audio, video_urls und reference_video.

Feld	Typ	Erforderlich / Standard	Verhalten
negative_prompt	string	Optional	Höchstens 500 Zeichen
first_frame	string	Optional	Öffentliche HTTP(S)-Bild-URL; Alternative zu input_reference
last_frame	string	Optional	Öffentliche HTTP(S)-URL eines Bilds für das letzte Frame; geben Sie zusätzlich ein erstes Frame an
reference_image	string oder string[]	Optional	1–10 öffentliche HTTP(S)-Referenzbild-URLs; verwenden Sie für mehrere Bilder ein Array
audio_url	string	Optional	Öffentliche HTTP(S)-Referenzaudio-URL; unterliegt der Medienvalidierung des Anbieters

Verwenden Sie in einer Anfrage entweder Frame-Steuerungen oder Referenzbilder. Natives metadata.input.media wird auf GMI nicht in diese Felder übersetzt.

Native Felder von Alibaba Cloud

Native strukturierte Eingaben gehören in metadata. Das direkte Senden offizieller input- oder parameters-Objekte auf oberster Ebene entspricht nicht dem APIMaster-Vertrag. Behalten Sie stets den erforderlichen prompt auf oberster Ebene bei.

Feld	Typ	Erforderlich / Standard	Verhalten
generate_audio	boolean	Offizieller nativer Standard true	Ob die Ausgabe eine Audiospur enthält; false bleibt erhalten
audio	boolean	Optional	Alias von generate_audio; geben Sie nur eines an
images	string[]	Optional	Wird in reference_image-Medieneinträge umgewandelt; dies sind keine geordneten ersten/letzten Frames. Nicht mit input_reference kombinieren
metadata	object	Optional	Umschließt native input und parameters; kann model nicht ändern
metadata.input	object	Optional	Nativer Eingabecontainer
metadata.input.prompt	string	Optional	Native Prompt-Überschreibung; bevorzugen Sie den alleinigen Prompt auf oberster Ebene
metadata.input.media	object[]	Optional	Native Mediensammlung, wobei jedes Element type und url enthält
metadata.input.media[].type	string	Erforderlich pro Element	first_frame, last_frame, reference_image, reference_audio, file, link; reference_video wird derzeit abgelehnt
metadata.input.media[].url	string	Erforderlich pro Element	Medienadresse; öffentliche HTTP(S)-URLs werden empfohlen. Offizielle temporäre OSS-URLs erfordern einen separat gültigen vorgelagerten Upload-Kontext; APIMaster stellt diesen Upload-Kontext nicht bereit
metadata.parameters	object	Optional	Nativer Parametercontainer; darf nicht null sein
metadata.parameters.resolution	string	720P	Großgeschriebene 480P, 720P, 1080P
metadata.parameters.ratio	string	16:9	Native Seitenverhältnisse einschließlich adaptive und 21:9
metadata.parameters.duration	integer	5	2–30; kein -1
metadata.parameters.audio	boolean	Offizieller nativer Standard true	Ausgabe-Audio-Schalter
metadata.parameters.prompt_extend	boolean	true	Muss für file / link true bleiben; explizites false unterliegt der oben genannten Serialisierungsbeschränkung
metadata.parameters.watermark	boolean	Offizieller nativer Standard false	Wasserzeichen-Schalter
metadata.parameters.seed	integer	Zufällig	-1 oder 0–2147483647; 0 unterliegt der oben genannten Serialisierungsbeschränkung

Native Optionen auf oberster Ebene überschreiben ihre entsprechenden Metadatenparameter. input_reference auf oberster Ebene ersetzt das native Medienarray; images hängt Referenzbild-Einträge an, wenn input_reference fehlt. Verwenden Sie einen Eingabestil und einen Parameterstil, um unbeabsichtigte Überschreibungen zu vermeiden. Verwenden Sie innerhalb von nativem input keine veralteten Felder img_url, first_frame_url, last_frame_url oder audio_url; der Adapter lehnt diese veralteten Medienfelder für Wan 3.0 ab.

Medienbeschränkungen

Die folgenden offiziellen nativen Medienregeln erläutern auch die anbieterseitige Validierung; dass ein Adapter eine URL akzeptiert, beweist nicht, dass die Medien gültig sind.

Medium	Beschränkungen / Integrationshinweise
Erste / letzte Frames	Höchstens jeweils eines; ein letztes Frame erfordert ein erstes Frame. Frame-Steuerungen nicht mit reference_image mischen
Referenzbilder	Höchstens 10; JPEG/JPG, PNG ohne Transparenz, BMP oder WEBP; jede Seite 240–8,000 px, Seitenverhältnis höchstens 8:1, höchstens 20 MB pro Bild
Referenzaudio	Native: höchstens 5, WAV/MP3, jeweils 1–15 Sekunden, zusammen höchstens 15 Sekunden, höchstens 15 MB pro Datei. GMI stellt ein audio_url bereit
Datei / Webseite	Nur nativ: höchstens eine Datei oder eine öffentlich lesbare Seite; kombinieren Sie file und link nicht. Offizielle Dateiformate: DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD; höchstens 100 MB, mit einem Limit von 50 Seiten für anwendbare Formate mit Seiten. Behalten Sie prompt_extend: true bei
Referenzvideo	Offiziell verfügbar, derzeit jedoch durch die native Abrechnungsvalidierung von APIMaster blockiert; auf GMI nicht verfügbar. Verwenden Sie hier keine Beispiele für Videobearbeitung oder -erweiterung aus der offiziellen API

Die offizielle native Obergrenze für kombinierte Medien beträgt 20 Elemente; individuelle und kombinierte Limits gelten weiterhin. Base64-Daten-URLs für Bilder sind Teil des offiziellen nativen Eingabeformats, werden jedoch von der GMI-URL-Validierung nicht akzeptiert. Bevorzugen Sie routenübergreifend herunterladbare HTTP(S)-URLs.

Beispiele

Text-zu-Video, gemeinsame Felder

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video-prime","prompt":"A paper boat drifting across a quiet pond at sunrise, gentle camera movement.","duration":5,"resolution":"720P","aspect_ratio":"16:9"}'

Erstes Frame, gemeinsame Felder

{"model":"wan3.0-video-prime","prompt":"The boat moves slowly forward, with soft ripples.","input_reference":"https://example.com/boat.png","duration":5,"resolution":"720P","aspect_ratio":"16:9"}

GMI erstes / letztes Frame

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","first_frame":"https://example.com/start.png","last_frame":"https://example.com/end.png","duration":5,"resolution":"720P","prompt_extend":false,"seed":0}

Native erste / letzte Frames und stumme Ausgabe

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","duration":5,"resolution":"720P","generate_audio":false,"metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}

Natives Referenzbild und Referenzaudio

{"model":"wan3.0-video-prime","prompt":"Animate the character in image 1, with the mood of audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}

Ersetzen Sie Beispiel-Medien-URLs durch echte öffentliche Dateien. Routenspezifische Beispiele erfordern die passende Route und unterliegen weiterhin den vorgelagerten Kombinationsprüfungen.

Antwort, Polling und Herunterladen

Die Erstellung gibt eine APIMaster-Task-ID zurück, zum Beispiel:

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video-prime","status":"queued"}

Feld	Bedeutung
id / task_id	APIMaster-Task-ID, keine vorgelagerte Task-ID
status	queued, in_progress, completed, failed
progress	Gemeldeter Fortschritt; keine Garantie für den Abschluss
error.code / error.message	Fehlerdetails, sofern zutreffend
metadata.url	Authentifizierte Inhaltsadresse, wenn sie bei Abschluss zurückgegeben wird

Fragen Sie alle 10–20 Sekunden mit demselben API-Schlüssel ab, bis ein Endstatus erreicht ist; eine erfolgreiche Erstellung bedeutet nur Akzeptanz. Die Generierung kann mehrere Minuten dauern. Fragen Sie eine akzeptierte Aufgabe ab, anstatt wiederholt kostenpflichtige Aufgaben zu erstellen.

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan-prime.mp4

Laden Sie das fertige Video zeitnah herunter und speichern Sie es; vorgelagerte Ergebnis-URLs können ablaufen. Wiederholtes Polling erzeugt keine weitere Generierungsgebühr.

Abrechnung und häufige Fehler

Die Abrechnung erfolgt pro Sekunde in der angeforderten Auflösung, wobei Routen-/Kontopreise auf der Modellkarte angezeigt werden. Die Übermittlung reserviert die geschätzte Gebühr. Die native Fertigstellung verwendet die zurückgegebene abrechenbare Dauer und den bei der Übermittlung eingefrorenen Preis; GMI folgt dem Vertrag zur reservierten Dauer. Fehlgeschlagene Aufgaben geben ihre Generierungsreservierung frei/erstatten sie. Deaktiviertes Audio bedeutet keine günstigere Stufe. Verwenden Sie das Nutzungsprotokoll für den endgültigen Betrag.

Fehler / Symptom	Aktion
duration must be an integer from 2 to 30	Verwenden Sie eine explizite Ganzzahl; -1 ist nicht integriert
unsupported Wan request field ...	Entfernen Sie ein von GMI nicht unterstütztes Feld, oder bestätigen Sie den Zugriff auf die passende native Route
unsupported aspect ratio	Verwenden Sie ein übliches Seitenverhältnis; 21:9 erfordert natives Routing
reference video requires an input-duration quote	Entfernen Sie das Referenzvideo; diese Funktion ist derzeit blockiert
prompt is required / Medienabruf fehlgeschlagen	Fügen Sie Text auf oberster Ebene hinzu; verwenden Sie öffentlich herunterladbare, gültige Medien
prompt_extend: false oder seed: 0 hat keine Wirkung auf native	Aktuelle Serialisierungsbeschränkung; verwenden Sie einen positiven Seed, und verlassen Sie sich nicht auf das Deaktivieren der Umschreibung

Quellen: offizielle Modellinformationen, offizielle native API-Referenz und offizieller Nutzungsleitfaden. Offizielle Funktionalität bedeutet nicht, dass dasselbe Feld auf jeder APIMaster-Route verfügbar ist.