Wan 3.0 Prime API Anleitung auf Deutsch: Text-zu-Video, Start-/Endbild und Referenz-zu-Video

TL;DR

• Wan 3.0 Prime (Wanxiang 3.0 beschleunigte Version) ist der schnelle Pfad von Alis Wan 3.0, der Modellname ist wan3.0-video-prime. Ein einziges Modell erledigt Text-zu-Video, Start-/Endbild-zu-Video und Referenz-zu-Video; Referenzmaterial kann ein Bild, Audio oder sogar ein Dokument bzw. eine Webseite sein. Einzelclips 2–30 Sekunden, standardmäßig mit Ton. Modellseite öffnen und direkt online generieren.
• Abrechnung pro Sekunde: 480P $0.0875 pro Sekunde, 720P $0.18, 1080P $0.36. 5 Sekunden 480P kosten nur $0.4375.
• Zwei Stolperfallen: Die Auflösung muss in Großbuchstaben angegeben werden: 480P / 720P / 1080P, und standardmäßig ist es 1080P; Prime akzeptiert keine Referenzvideos.

Zuerst das Ergebnis ansehen

Text-zu-Video, 480P, 5 Sekunden, mit Ton (wenn man den Ton einschaltet, hört man Regen, Verkehr und das Zischen des Grills):

Rain streaking down a narrow neon-lit alley at night; a slow dolly-forward past
steaming street-food stalls, magenta and cyan reflections rippling in the wet
pavement, a tabby cat darting between crates mid-shot. Ambient sound: steady
rain, distant traffic hiss, the sizzle of a grill and a low synth drone.

Mit diesem Prompt generieren → (5 Sekunden, 480P, 16:9, Ton an)

wan3.0-video-prime, 480P, 5 Sekunden, mit Ton, $0.4375.

Referenz-zu-Video: Übergib ein Bild einer Keramikfuchs-Figur und lass sie sich bewegen, während das Aussehen unverändert bleibt.

Bring the referenced ceramic fox figurine to life: it slowly turns its head
toward camera, blinks, and tilts with a curious expression; subtle idle
breathing, a light breeze stirring the tiny scarf, soft studio key light on a
clean seamless backdrop, smooth loopable motion.

Mit diesem Prompt generieren → (lade dein Referenzbild hoch, 5 Sekunden, 480P, 9:16)

wan3.0-video-prime, Referenzbild, 480P, 5 Sekunden, 9:16, $0.4375.

curl: das erste Video

5 Sekunden 480P, $0.4375:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {
      "prompt": "Eine orange getigerte Katze liegt gähnend auf einer sonnendurchfluteten Fensterbank, der Schwanz schwingt leicht, die Kamera fährt langsam näher, warme Farbtöne",
      "resolution": "480P",
      "duration": 5,
      "aspect_ratio": "16:9",
      "audio": false
    }
  }'

Nachdem data.taskId zurückgegeben wurde, prüfe mit GET /v1/tasks/{taskId}, ob status gleich success ist, und lade dann output[0].url herunter.

Python: einreichen, abfragen, herunterladen

# pip install requests; vorher export HIAPI_KEY=dein Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=900, **inp):
    # Beim erneuten Einreichen derselben Aufgabe denselben Idempotency-Key mitschicken, um doppelte Abbuchungen zu vermeiden
    r = requests.post(API, json={"model": "wan3.0-video-prime", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# Referenz-zu-Video: das Produkt im Referenzbild in Bewegung bringen, 480P 5 Sekunden ($0.4375)
url = generate(
    prompt="Lass den Parfümflakon aus dem Referenzbild langsam auf schwarzem Marmor rotieren, Seitenlicht streift über den Flakon, die Kamera fährt langsam näher",
    reference_image_urls=["https://your-cdn.example.com/perfume.jpg"],
    resolution="480P", duration=5, aspect_ratio="9:16", audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Drei Verwendungsarten

Verwendung	Was übergeben wird	Hinweis
Text-zu-Video	nur prompt
Start-/Endbild	first_frame_url, optional zusätzlich last_frame_url	Nicht gleichzeitig mit Referenzmaterial verwendbar
Referenz-zu-Video	reference_image_urls (max. 10 Bilder), reference_audio_urls (max. 5 Segmente, müssen zusammen mit Bildern verwendet werden), reference_file_urls oder reference_link_urls (je max. 1, eines von beiden)	Im Prompt mit Image1, Audio1 in Reihenfolge auf das Material verweisen

Referenzdokumente und Webseiten sind eine Besonderheit von Wan 3.0: Man kann dem Modell eine Markenrichtlinie als PDF oder einen Produktseiten-Link übergeben und es nach den darin enthaltenen Informationen ein Video erzeugen lassen. Webseiten müssen ohne Login geöffnet werden können.

Parameterübersicht

Parameter	Werte	Hinweis
prompt	String, erforderlich	Szene, Aktion, Kamera, Licht und Ton beschreiben
resolution	480P / 720P / 1080P, Standard 1080P	Großbuchstaben, bestimmt direkt den Preis
duration	Ganzzahl 2–30, Standard 5	Einheit Sekunden
aspect_ratio	adaptive 16:9 4:3 1:1 3:4 9:16, Standard adaptive	adaptive wählt automatisch anhand von Material und Prompt
audio	Standard true	Synchronisierte Tonspur, ohne Aufpreis
seed	0–2147483647	Fester Seed für einfache Reproduzierbarkeit
first_frame_url / last_frame_url	Bild-URL	Start-/Endbild
reference_image_urls usw.	siehe obige Tabelle	Referenz-zu-Video

Kosten berechnen

Dauer	480P ($0.0875/Sek.)	720P ($0.18/Sek.)	1080P ($0.36/Sek.)
5 Sekunden	$0.4375	$0.90	$1.80
10 Sekunden	$0.875	$1.80	$3.60
30 Sekunden	$2.625	$5.40	$10.80

Erst mit 480P die Prompts abstimmen, nach der Finalisierung auf 720P oder 1080P wechseln. Wenn es nicht eilt, kostet die Wan 3.0 Standardversion (wan3.0-video) in 720P nur $0.08 pro Sekunde und akzeptiert auch Referenzvideos. Die vollständigen Preise findest du unter Wan 3.0 Prime API Preise.

Vor dem Livegang beachten

• Callbacks statt Polling verwenden: Auf der obersten Ebene der Anfrage (auf derselben Ebene wie input) "callback": {"url": "https://deine-domain/hiapi/callback"} hinzufügen und nach taskId deduplizieren.
• Rechtzeitig übertragen: output[0].url ist ein temporärer Link.
• Bei Wiederholungen Idempotenz-Key mitgeben: Den Header Idempotency-Key hinzufügen; bei demselben Key wird die Aufgabe nur einmal erstellt.
• Automatische Rückerstattung bei Fehlschlag: Es wird nur für erfolgreich generierte Videos abgerechnet.

Häufige Fragen

Warum gibt es einen Fehler bei 720p?

Die Auflösung muss in Großbuchstaben geschrieben werden. Kleinschreibung gibt 400 zurück: resolution: value must be one of '480P', '720P', '1080P'.

Kann man ein Referenzvideo übergeben?

Prime nicht, es akzeptiert den Parameter reference_video_urls nicht. Wenn du ein Referenzvideo brauchst, wechsle zur Wan 3.0 Standardversion wan3.0-video.

Kann der Ton abgeschaltet werden?

Ja, audio: false. Standardmäßig ist er an, der Preis bleibt gleich.

Worin unterscheiden sich Prime und die Wan 3.0 Standardversion?

Parameter und Ausgabespezifikationen sind gleich; Prime ist der beschleunigte Pfad. Die Standardversion hat ebenfalls eine 480P-Stufe ($0.04/Sek.), aber 720P und 1080P sind pro Sekunde mehr als doppelt so teuer, und sie akzeptiert keine Referenzvideos.

Weitere Prompt-Schreibweisen findest du unter Wan 3.0 Prime Prompt-Beispiele, den Vergleich mit der vorherigen Generation unter Wan 3.0 oder Wan 2.7: Welches wählen. Du kannst auch direkt auf der Modellseite die regnerische Gasse generieren.