Wie verwende ich die Wan 2.7 Video-API? Tutorial für Text-zu-Video und Bild-zu-Video auf Chinesisch

TL;DR

• Wan 2.7 ist Alibabas Videomodell. Auf HiAPI gibt es Text-zu-Video wan2.7-video/text-to-video und Bild-zu-Video wan2.7-video/image-to-video, je 2–15 Sekunden pro Clip. Modellseite öffnen und direkt online generieren – neue Nutzer erhalten bei der Registrierung 200 Credits.
• Abrechnung pro Sekunde, Text- und Bild-zu-Video zum gleichen Preis: 720P $0.10 pro Sekunde, 1080P $0.167 pro Sekunde. 5 Sekunden 720P kosten $0.50.
• Zwei leicht zu übersehende Fallstricke: Die Auflösung muss in Großbuchstaben geschrieben werden, 720P / 1080P, Standard ist 1080P; der Seitenverhältnis-Parameter bei Text-zu-Video heißt ratio, nicht aspect_ratio.

Zuerst die Ergebnisse ansehen

Text-zu-Video, Beispiel von der Modellseite, chinesischer Prompt:

一位穿着白色毛衣的年轻女子坐在咖啡馆窗边，窗外是雨天的街道，她轻轻端起咖啡杯，目光望向窗外，暖黄色灯光映照在她的脸上，雨滴顺着玻璃缓缓流下，电影级浅景深，35mm胶片质感，温暖色调，慢镜头特写

Mit diesem Prompt generieren →（1080P、16:9）

wan2.7-video/text-to-video Beispiel von der Modellseite, 1080P, ca. 8 Sekunden, zum aktuellen Preis ca. $1.336.

Bild-zu-Video mit einem Knetanimations-Bauernhofbild als Startframe:

黏土动画风格，欢乐农场场景缓缓活起来。奶牛妈妈慢慢咀嚼嘴里的青草，小牛好奇地歪头张望。身后的母鸡们低头啄食地上的谷粒，小狗摇着尾巴朝镜头方向小跑几步。泥坑里的小猪满足地打了个滚，溅起小小的泥花。远处红色谷仓的风车缓缓转动，绿色山丘上白云悠悠飘过。地面上的小花随微风轻轻摇摆，整个画面充满温暖的午后阳光，定格动画质感，童趣十足。

Mit diesem Prompt generieren →（eigenes Startframe hochladen）

wan2.7-video/image-to-video Beispiel von der Modellseite, 1080P, ca. 8 Sekunden, zum aktuellen Preis ca. $1.336.

Den Prompt für Bild-zu-Video schreibt man Figur für Figur nach dem Muster „Wer macht was“: Kuh kaut Gras, Hühner picken Körner, Hund läuft, Ferkel wälzt sich. Gibt man jeder Figur im Bild eine kleine Aktion, wird das ganze Bild lebendig.

Zwei Wege zum Einstieg

Online ausprobieren (ohne Programmieren)

1. Öffnen Sie die Modellseite Wan 2.7 Text-zu-Video und registrieren oder melden Sie sich an.
2. Prompt einfügen, Dauer, Auflösung und Seitenverhältnis wählen.
3. Auf Generieren klicken und das fertige Video direkt herunterladen.

API-Aufruf

1. Erstellen Sie im Dashboard einen API Key.
2. POST https://api.hiapi.ai/v1/tasks sendet die Aufgabe und gibt eine taskId zurück.
3. GET /v1/tasks/{taskId} fragt den Status ab; wenn status gleich success ist, das Video von output[0].url herunterladen.

curl: das erste Video

5 Sekunden 720P, $0.50:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video/text-to-video",
    "input": {
      "prompt": "一只橘猫趴在洒满阳光的窗台上打哈欠，尾巴轻轻摆动，暖色调，浅景深",
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5
    }
  }'

Rückgabe:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Ergebnis abfragen:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: senden, pollen, herunterladen

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(model, timeout_s=900, **params):
    body = {"model": model, "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{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)

url = generate(
    "wan2.7-video/text-to-video",
    prompt="一只橘猫趴在洒满阳光的窗台上打哈欠，尾巴轻轻摆动，暖色调，浅景深",
    resolution="720P", ratio="9:16", duration=5,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Bild-zu-Video: Material mit media übergeben

Bei Bild-zu-Video verwendet man nicht image_url, sondern das Array media, bei dem jeder Eintrag Typ und Adresse angibt, 1–3 Einträge:

{
  "model": "wan2.7-video/image-to-video",
  "input": {
    "prompt": "镜头缓慢推进，花瓣被风吹起，人物转头微笑",
    "media": [
      {"type": "first_frame", "url": "https://your-cdn.example.com/start.jpg"},
      {"type": "last_frame", "url": "https://your-cdn.example.com/end.jpg"}
    ],
    "resolution": "720P",
    "duration": 5
  }
}

type gibt es in vier Varianten:

type	Funktion
first_frame	Startframe-Bild
last_frame	Endframe-Bild, dient zusammen mit dem Startframe als Übergang
driving_audio	Treiber-Audio, lässt das Bild sich zum Ton bewegen
first_clip	Erster Videoclip, an den die weitere Generierung anschließt

Parameterübersicht

Parameter	Werte	Beschreibung
prompt	String, erforderlich	Maximal 5000 Zeichen, Chinesisch und Englisch möglich
negative_prompt	String	Inhalte, die nicht erscheinen sollen, maximal 500 Zeichen
resolution	720P / 1080P, Standard 1080P	Großbuchstaben, bestimmt direkt den Preis
ratio	16:9 9:16 1:1 4:3 3:4, Standard 16:9	Nur Text-zu-Video
duration	Ganzzahl 2–15, Standard 5	Einheit Sekunden
audio_url	wav/mp3, 2–30 Sekunden, max. 15 MB	Nur Text-zu-Video, optional
prompt_extend	Standard true	Optimiert den Prompt automatisch; für exakte Generierung nach Originaltext auf false setzen
seed	0–2147483647	Fester Seed zur einfachen Reproduzierbarkeit
watermark	Standard false	Ob ein KI-Generierungs-Wasserzeichen hinzugefügt wird

Kosten berechnen

Dauer	720P ($0.10/Sekunde)	1080P ($0.167/Sekunde)
2 Sekunden	$0.20	$0.334
5 Sekunden	$0.50	$0.835
10 Sekunden	$1.00	$1.67
15 Sekunden	$1.50	$2.505

Mit $10 lassen sich bei 720P 100 Sekunden generieren. resolution ist standardmäßig 1080P; beim Ausprobieren von Prompts 720P angeben und 40 % sparen.

Vor dem Produktivbetrieb beachten

• Callbacks statt Polling: Auf oberster Ebene der Anfrage (gleichrangig mit input) "callback": {"url": "https://deine-domain/hiapi/callback"} hinzufügen und nach taskId deduplizieren.
• Rechtzeitig sichern: output[0].url ist ein temporärer Link, sofort nach Erhalt im eigenen Speicher ablegen.
• Retries mit Idempotenzschlüssel: Im Request-Header Idempotency-Key hinzufügen, damit ein Retry mit demselben Schlüssel nur eine Aufgabe erstellt.
• Automatische Rückerstattung bei Fehler: Es wird nur für erfolgreich generierte Videos abgerechnet.

Häufige Fragen

Kann die Auflösung kleingeschrieben werden, 720p?

Nein. Kleinschreibung führt direkt zu 400: resolution: value must be one of '720P', '1080P'.

Warum führt aspect_ratio zu einem Fehler?

Der Seitenverhältnis-Parameter bei Wan 2.7 Text-zu-Video heißt ratio. Übergibt man aspect_ratio, wird 400 zurückgegeben: additional properties 'aspect_ratio' not allowed.

Wie stellt man das Seitenverhältnis bei Bild-zu-Video ein?

Bild-zu-Video hat keinen Seitenverhältnis-Parameter und folgt dem Startframe.

Kann man ein 15-Sekunden-Video generieren?

Ja, duration reicht von 2 bis 15 Sekunden.

Wan 2.7 oder Wan 3.0 – wie wählen?

Wan 3.0 auf HiAPI ist Referenz-zu-Video und verwendet Referenzbilder, um Personen und Produkte festzulegen; für reines Text-zu-Video oder Bild-zu-Video Wan 2.7 verwenden.

Weitere Formulierungen finden Sie unter Wan 2.7 Text-zu-Video Prompt-Beispiele (Englisch). Wenn Sie erst einmal ein Video testen möchten, auf der Modellseite generieren.