Comment utiliser l'API vidéo Wan 2.7 ? Tutoriel en chinois : texte-vers-vidéo et image-vers-vidéo

TL;DR

• Wan 2.7 est le modèle vidéo d'Alibaba. Sur HiAPI, il existe en texte-vers-vidéo wan2.7-video/text-to-video et en image-vers-vidéo wan2.7-video/image-to-video, pour des clips de 2 à 15 secondes. Ouvrez la page du modèle pour générer en ligne ; les nouveaux utilisateurs inscrits reçoivent 200 crédits.
• Facturation à la seconde, même prix pour le texte-vers-vidéo et l'image-vers-vidéo : 720P à 0,10 $ par seconde, 1080P à 0,167 $ par seconde. 5 secondes en 720P coûtent 0,50 $.
• Deux pièges fréquents : la résolution doit être écrite en majuscules 720P / 1080P, et la valeur par défaut est 1080P ; le paramètre de format d'image du texte-vers-vidéo s'appelle ratio, et non aspect_ratio.

Voyons d'abord le résultat

Texte-vers-vidéo, exemple de la page du modèle, prompt en chinois :

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

Générer avec ce prompt → (1080P, 16:9)

Exemple de la page du modèle wan2.7-video/text-to-video, 1080P, environ 8 secondes, environ 1,336 $ au tarif actuel.

Image-vers-vidéo, avec une image de ferme en pâte à modeler comme première image :

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

Générer avec ce prompt → (téléversez votre première image)

Exemple de la page du modèle wan2.7-video/image-to-video, 1080P, environ 8 secondes, environ 1,336 $ au tarif actuel.

Pour l'image-vers-vidéo, écrivez le prompt personnage par personnage selon le principe « qui fait quoi » : la vache mâche l'herbe, les poules picorent, le chien trottine, le cochon se roule. Donnez une petite action à chaque personnage de l'image, et toute l'image prend vie.

Deux façons de démarrer

Essai en ligne (sans code)

1. Ouvrez la page du modèle Wan 2.7 texte-vers-vidéo, inscrivez-vous ou connectez-vous.
2. Collez le prompt, choisissez la durée, la résolution et le format d'image.
3. Cliquez sur générer, puis téléchargez directement la vidéo une fois produite.

Appel API

1. Créez une clé API dans la console.
2. POST https://api.hiapi.ai/v1/tasks pour soumettre la tâche, qui renvoie un taskId.
3. GET /v1/tasks/{taskId} pour vérifier l'état ; lorsque status vaut success, téléchargez la vidéo depuis output[0].url.

curl : votre première vidéo

5 secondes en 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éponse :

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

Vérifier le résultat :

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

Python : soumettre, interroger, télécharger

# 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)

Image-vers-vidéo : transmettre les médias avec media

Pour l'image-vers-vidéo, on n'utilise pas image_url, mais un tableau media, où chaque élément précise son type et son adresse, de 1 à 3 éléments :

{
  "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 propose quatre valeurs :

type	Rôle
first_frame	Image de première frame
last_frame	Image de dernière frame, utilisée avec la première pour créer une transition
driving_audio	Audio de pilotage, pour faire bouger l'image au rythme du son
first_clip	Premier clip vidéo, à partir duquel la génération se poursuit

Aperçu des paramètres

Paramètre	Valeurs	Description
prompt	chaîne, obligatoire	5000 caractères maximum, en chinois ou en anglais
negative_prompt	chaîne	Contenu à éviter, 500 caractères maximum
resolution	720P / 1080P, par défaut 1080P	Majuscules, détermine directement le prix
ratio	16:9 9:16 1:1 4:3 3:4, par défaut 16:9	Texte-vers-vidéo uniquement
duration	entier de 2 à 15, par défaut 5	En secondes
audio_url	wav/mp3, 2 à 30 secondes, 15 Mo maximum	Texte-vers-vidéo uniquement, facultatif
prompt_extend	par défaut true	Optimisation automatique du prompt ; mettez false pour générer exactement selon le texte d'origine
seed	0–2147483647	Seed fixe pour faciliter la reproduction
watermark	par défaut false	Ajouter ou non un filigrane de génération IA

Calculons le coût

Durée	720P (0,10 $/seconde)	1080P (0,167 $/seconde)
2 secondes	0,20 $	0,334 $
5 secondes	0,50 $	0,835 $
10 secondes	1,00 $	1,67 $
15 secondes	1,50 $	2,505 $

Avec 10 $, vous pouvez générer 100 secondes en 720P. resolution vaut 1080P par défaut ; écrivez 720P pendant le réglage du prompt pour économiser 40 %.

À vérifier avant la mise en production

• Utilisez un callback plutôt que l'interrogation répétée : ajoutez au niveau supérieur de la requête (au même niveau que input) "callback": {"url": "https://votre-domaine/hiapi/callback"}, et dédupliquez par taskId.
• Archiver rapidement : output[0].url est un lien temporaire ; une fois obtenu, enregistrez-le immédiatement dans votre propre stockage.
• Idempotence lors des nouvelles tentatives : ajoutez l'en-tête Idempotency-Key ; une nouvelle tentative avec la même clé ne crée qu'une seule tâche.
• Remboursement automatique en cas d'échec : la facturation ne s'applique qu'aux vidéos générées avec succès.

Questions fréquentes

Peut-on écrire la résolution en minuscules 720p ?

Non. Les minuscules renvoient directement une erreur 400 : resolution: value must be one of '720P', '1080P'.

Pourquoi aspect_ratio renvoie-t-il une erreur ?

Le paramètre de format d'image du texte-vers-vidéo Wan 2.7 s'appelle ratio. Passer aspect_ratio renvoie une erreur 400 : additional properties 'aspect_ratio' not allowed.

Comment définir le format d'image en image-vers-vidéo ?

L'image-vers-vidéo n'a pas de paramètre de format d'image ; il suit la première image.

Peut-on générer une vidéo de 15 secondes ?

Oui, duration va de 2 à 15 secondes.

Comment choisir entre Wan 2.7 et Wan 3.0 ?

Sur HiAPI, Wan 3.0 est un modèle de vidéo par référence, qui verrouille les personnages et les produits à l'aide d'images de référence ; si vous voulez seulement du texte-vers-vidéo ou de l'image-vers-vidéo, utilisez Wan 2.7.

Pour d'autres exemples de rédaction, consultez Exemples de prompts pour Wan 2.7 texte-vers-vidéo (en anglais). Pour d'abord essayer une vidéo, allez générer sur la page du modèle.