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 |
