APIMaster.ai

Wan 3.0 Video API

Parameter, Medienkombinationen, asynchrone Aufgaben, Downloads und sekundengenaue Abrechnung für wan3.0-video auf APIMaster.

Wan 3.0 Video API

wan3.0-video ist das Standardmodell von Wan 3; es ist ein separates Modell von wan3.0-video-prime. Es unterstützt Text, Bilder, Video, Audio, Dokumente und öffentliche Webseiten. Jede erfolgreiche Aufgabe erzeugt ein MP4/H.264-Video mit bis zu 30 Sekunden. Integration geprüft: 2026-11-17. Pro Anfrage sind insgesamt höchstens 20 Medienobjekte zulässig. Das erzeugte Video hat 30 fps.

Endpunkte und Authentifizierung

Vorgang Endpunkt
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

Authorization: Bearer YOUR_API_KEY · Content-Type: application/json

Alle Anfrageparameter

Verwenden Sie pro Anfrage ein Medienformat. Verwenden Sie metadata.input.media für gemischte Referenzmedien oder Dokumente.

Parameter Typ Erforderlich / Standard Bedeutung und gültige Werte
model string Erforderlich Genau wan3.0-video; nicht durch Prime ersetzen
prompt string Erforderlich Beschreiben Sie das Ergebnis auf Chinesisch oder Englisch; offizielles Limit 20.000 Zeichen, längerer nativer Text wird abgeschnitten. Beziehen Sie sich in Medienreihenfolge auf Image 1, Video 1, Audio 1; jeder Medientyp hat seine eigene Nummerierung
duration integer 5 2–30 Ausgabesekunden; -1 lässt das Modell die Dauer wählen. Bei Referenzvideo dürfen Eingabe- plus Ausgabedauer 30 Sekunden nicht überschreiten
seconds string Optional Dauer-Alias, z. B. "5" oder "-1"; muss mit duration übereinstimmen, wenn beide angegeben werden
resolution string 1080P 480P, 720P, 1080P; Werte auf der obersten Ebene in Kleinbuchstaben werden normalisiert
aspect_ratio string adaptive adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
ratio string Optional Alias für aspect_ratio; für die Videoerweiterung wird adaptive empfohlen
size string Optional Kompatibilitäts-Alias: Auflösungsstufe oder eine unterstützte Pixelzuordnung wie 1280x720; bevorzugen Sie explizite Auflösung und ein explizites Seitenverhältnis, keine beliebigen Pixelgrößen
generate_audio boolean true upstream Ob die Ausgabe eine Audiospur hat. Ein explizites false bleibt erhalten. Audio ändert den Sekundentarif nicht
audio boolean Optional Alias für generate_audio; verwenden Sie nur einen Audio-Schalter
prompt_extend boolean true Intelligente Prompt-Umschreibung; ein explizites false bleibt erhalten. Muss bei Dokument-/Seiteneingabe true sein
watermark boolean false upstream Wasserzeichen zur Ausgabe hinzufügen; ein explizites false bleibt erhalten
seed integer Zufällig -1 oder 0–2147483647. Auslassen oder -1 fordert einen zufälligen Seed an; 0 wird weitergegeben. Wiederholte Seeds garantieren keine identische Ausgabe
input_reference string Optional URL des Bildes für das erste Frame; ersetzt das native Medien-Array. Kombinieren Sie keine Eingabestile
images string[] Optional Komfort-Array, das als reference_image-Elemente angehängt wird, wenn input_reference fehlt
metadata object Optional Container für die nativen Objekte unten; kann das ausgewählte Modell nicht ändern
metadata.input object Optional Natives Eingabeobjekt
metadata.input.prompt string Optional Nativer Prompt-Override; behalten Sie den erforderlichen prompt auf der obersten Ebene bei
metadata.input.media object[] Optional Geordnetes Medien-Array. Jedes Element erfordert type und url; siehe Grenzen unten
metadata.input.media[].type string Pro Element erforderlich first_frame, last_frame, reference_image, reference_video, reference_audio, file, link
metadata.input.media[].url string Pro Element erforderlich Öffentliche HTTP(S)-Medien-URL; Bildtypen akzeptieren auch eine Zeichenkette data:{MIME_type};base64,.... Nicht-Bildmedien erfordern eine öffentliche URL
metadata.parameters object Optional Natives Parameterobjekt; darf nicht null sein
metadata.parameters.resolution string 1080P Großschreibung 480P, 720P, 1080P
metadata.parameters.ratio string adaptive Dieselben oben aufgeführten Seitenverhältniswerte
metadata.parameters.duration integer 5 2–30 oder -1; dieselbe Einschränkung für die kombinierte Dauer
metadata.parameters.audio boolean true upstream Derselbe Ausgabe-Audio-Schalter
metadata.parameters.prompt_extend boolean true Derselbe Schalter für die Prompt-Umschreibung; file/link erfordert true
metadata.parameters.watermark boolean false upstream Derselbe Wasserzeichen-Schalter
metadata.parameters.seed integer Zufällig Derselbe Seed-Bereich, einschließlich explizitem 0

Die nativen Felder negative_prompt, img_url, first_frame_url, last_frame_url und audio_url sind keine Mediensteuerungen von Wan 3. Verwenden Sie stattdessen das dokumentierte Medien-Array.

Medienlimits und gültige Kombinationen

Medientyp Anzahl und Einschränkungen
first_frame, last_frame Höchstens jeweils eines. Das letzte Frame erfordert das erste Frame. Frame-Steuerungen können nicht mit Referenz-, Datei- oder Link-Typen kombiniert werden
reference_image Höchstens 10. JPEG/JPG, PNG ohne Transparenz, BMP oder WEBP; jede Seite 240–8,000 Pixel, Seitenverhältnis höchstens 8:1, jede Datei höchstens 20 MB
reference_video Höchstens 5 MP4/MOV-Clips; jeweils 1–15 Sekunden, kombinierte Eingabe höchstens 15 Sekunden; mindestens 16 fps; jede Seite 240–4,096 Pixel, Seitenverhältnis höchstens 8:1, jede Datei höchstens 100 MB
reference_audio Höchstens 5 WAV/MP3-Clips; jeweils 1–15 Sekunden, insgesamt höchstens 15 Sekunden; jede Datei höchstens 15 MB
file Höchstens eine DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD-Datei; höchstens 100 MB. PDF-, DOCX-, DOC-, PPTX-, PPT- und KEY/PAGES-Dokumente mit Seiten haben ein Limit von 50 Seiten
link Höchstens eine öffentlich zugängliche Seite ohne Login; nicht mit file kombinieren

Referenzbilder, -videos und -audios können kombiniert werden. Eine Datei oder ein Link kann Referenzmedien begleiten. Der First/Last-Frame-Modus akzeptiert nur Frame-Steuerungen; verwenden Sie für die audiogesteuerte Generierung den Modus Referenzbild plus Referenzaudio. Medienanalyse und Inhaltsmoderation unterliegen weiterhin vorgelagerten Prüfungen.

Text-zu-Video verwendet einen Prompt ohne Medien. Die First-Frame-Animation verwendet first_frame; Übergänge verwenden first_frame plus last_frame. Die Referenzgenerierung verwendet die Referenztypen. Für Bearbeitung oder Verlängerung geben Sie reference_video an und beschreiben Sie die Bearbeitung oder Verlängerung im Prompt; verwenden Sie adaptive für die Verlängerung.

Beispiele

Text-zu-Video

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'

Erstes und letztes Bild

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

Referenzbild und Audio

{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm 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"}]}}}

Videobearbeitung / -erweiterung und intelligente Dauer

{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}

Dokument / Webseite

{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}

Ersetzen Sie alle Beispiel-URLs durch echte öffentliche Medien. Bei Web-Eingaben ersetzen Sie das Dateielement durch {"type":"link","url":"https://example.com/product"}. Das Beispiel mit dem ersten Bild funktioniert auch ohne das Element für das letzte Bild.

Antworten, Polling, Downloads und Logs

Die Erstellung liefert eine APIMaster-Task-ID zurück, nicht die ID des Upstream-Anbieters:

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
Antwortfeld Bedeutung
id / task_id Plattform-Task-ID, die für Abfrage und Download verwendet wird
status queued, in_progress, completed, failed
progress Fortschrittsanzeige; auf den Endstatus warten
error.code, error.message Fehlerinformationen, sofern zutreffend
metadata.url Position des Inhalts, wenn bei Abschluss zurückgegeben

Fragen Sie etwa alle 15 Sekunden mit demselben API-Schlüssel ab. Erstellen Sie keinen weiteren Task, um den Fortschritt zu prüfen. Die Task-IDs und Ausgabe-URLs des nativen Anbieters laufen nach 24 Stunden ab; laden Sie erfolgreiche Ergebnisse umgehend herunter und bewahren Sie sie auf. Der authentifizierte Content-Endpunkt von APIMaster ist dem Speichern temporärer Upstream-URLs vorzuziehen.

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 wan3.mp4

Das Nutzungsprotokoll enthält den Task und das erfolgreiche Videoergebnis. Prüfen Sie die endgültige Abrechnung nach Abschluss; die Annahme ist kein Beweis für eine erfolgreiche Generierung. Wiederholtes Polling verursacht keine weiteren Generierungskosten.

Abrechnung

Sekundenpreise finden Sie auf der Modellkarte.

APIMaster addiert die Dauer aller Eingabevideos zur Dauer des Ausgabevideos, rundet die Summe einmal auf volle Sekunden auf und multipliziert sie mit dem Sekundenpreis der gewählten Ausgabeauflösung. 2,3 s Eingabe und 5 s Ausgabe ergeben 8 abrechenbare Sekunden. Ohne Eingabevideo zählt nur die Ausgabedauer. Ein Angebot und eine Angabe der Eingabedauer sind entbehrlich. Bei fehlgeschlagener Generierung wird der reservierte Betrag freigegeben. Der Endbetrag steht im Nutzungsprotokoll.

Fehler und Korrekturen

Symptom Korrektur
Ungültige Dauer/Auflösung/Seitenverhältnis Verwenden Sie die oben genannten Enum-Werte und Bereiche; die intelligente Dauer ist genau -1
Frame-/Referenzkonflikt, letztes Frame ohne erstes Befolgen Sie die Kombinationsregeln
Datei/Link plus deaktivierte Neuschreibung Setzen Sie prompt_extend:true
Medienabruf-, Format- oder Dauerfehler Verwenden Sie öffentliche Dateien, die alle Größen-, Format- und Dauerbeschränkungen erfüllen
Fehlender Prompt Behalten Sie einen nichtleeren prompt auf oberster Ebene für die APIMaster-API bei
Aufgabe fehlgeschlagen oder moderiert Prüfen Sie error, korrigieren Sie dann die Anfrage; werten Sie die Annahme nicht als Erfolg