wan3.0-video-prime API

Verwenden Sie die genaue Modell-ID wan3.0-video-prime. Das Modellfeld muss genau mit dieser Seite übereinstimmen.

Beispielausgabewan3.0-video-primePOST /v1/videos5.0s

Parameter: duration=5resolution=1080Pratio=16:9

Prompt: A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, photoreal, no text.

Anfrage, die dieses Beispiel erstellt hat

{
  "model": "wan3.0-video-prime",
  "prompt": "A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080P",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Authentifizierung und Endpunkt

Verwenden Sie einen Modelflare-API-Schlüssel mit https://modelflare.dev/v1. Der Gateway-Einstiegspunkt ist POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Erstellen Sie eine Aufgabe

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

Umfrage und Download

Speichern Sie die Aufgaben-ID. Abfrage GET /v1/videos/{task_id} und Download mit GET /v1/videos/{task_id}/content. Ergebnis-URLs können ablaufen. Übertragen Sie die Datei daher umgehend.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Notizen anfordern

Wan verwendet üblicherweise input und parameters; Frame-Guided- und Reference-Media-Modi dürfen nicht gemischt werden.

Parameter anfordern

Wan3.0 verwendet input.prompt oder input.media mit Ausgabesteuerungen in parameters. Medien können Frames, Referenzen, Audio, Dateien oder Webseiten darstellen.

Feld	Erforderlich	Notizen
model	Ja	wan3.0-video-prime
input.prompt	Bedingt	Geben Sie dies an oder input.media
input.media[]	Bedingt	first_frame, last_frame, reference_*, file oder link
parameters.resolution	Nein	480P / 720P / 1080P (Standard 1080P)
parameters.ratio	Nein	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	Nein	2–30 Sekunden oder -1 für automatische Dauer
parameters.audio	Nein	Ob synchronisiertes Audio generiert werden soll
parameters.prompt_extend	Nein	Legen Sie „false“ fest, wenn dieser dedizierte Modellvertrag dies erfordert
parameters.seed	Nein	Optionaler zufälliger Startwert
parameters.watermark	Nein	Ob ein Wasserzeichen hinzugefügt werden soll

Eingabe- und Ausgabegrenzen

Wan3.0 unterstützt Text, erste/letzte Bilder, bis zu 10 Referenzbilder, 5 Referenzvideos, 5 Referenzaudioclips und eine Datei- oder Webseiteneingabe. Die Ausgabe erfolgt in 480P, 720P oder 1080P für 2–30 Sekunden oder -1 automatisches Timing. Erste/letzte Frames, Referenzmedien, Dateien und Webseiten sind sich gegenseitig ausschließende Workflows, die von input.media[].type ausgewählt werden.

Dokumentierte Workflow-Beispiele

Wan3.0 verwendet einen input/parameters-Umschlag für Text, Rahmenführung, Referenzmedien, Dateien und Webseiten; Diese Arbeitsabläufe schließen sich gegenseitig aus.

Erstes und letztes Bild

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

Referenzmedien

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

Fehler und fehlgeschlagene Aufgaben

Ungültige Modellparameter geben ein 4xx mit einer Anforderungs-ID zurück. Eine asynchrone Aufgabe kann auch nach erfolgreicher Erstellung als fehlgeschlagen gelten. Verwenden Sie error_code und error_message aus der Umfrageantwort als letzten Aufgabengrund. Wiederholen Sie dieselbe Anfrage nicht mit einer anderen JSON-Form.

Unterstützter Bereich

Auf dieser Seite werden Modelflare-Modellgenerierungs- und -bearbeitungsaufrufe behandelt. Such- oder Kartenanreicherung, Sprachverwaltung und Elementbibliotheksverwaltung sind Ressourcen-APIs außerhalb dieser öffentlichen Modellaufrufoberfläche und keine erforderlichen Anforderungsfelder.

Preise und Abrechnung

Dieses Modell verwendet eine Videoabrechnung pro Sekunde. Den aktuellen Kundenpreis, den Referenzlistenpreis und die vollständige Spezifikation finden Sie auf der Modellpreisseite.

Hinweis

Diese Seite dokumentiert die öffentliche Schnittstelle von Modelflare. Bei den hier dargestellten Feldern und Grenzen handelt es sich um den aktuellen Vertrag.

Varianten

Modell-ID	Unterschied
wan3.0-video-prime	Das auf dieser Seite dokumentierte Modell.