Tutoriel API Wan 3.0 Prime en chinois : texte-à-vidéo, première/dernière image et vidéo à partir de références

TL;DR

• Wan 3.0 Prime (version accélérée de Wanxiang 3.0) est la voie rapide de Wan 3.0 d'Alibaba, nom du modèle wan3.0-video-prime. Un seul modèle suffit pour la génération de vidéo à partir de texte, à partir de la première et derniere image, ou à partir de références ; les éléments de référence peuvent être des images, un audio, voire un document ou une page web. Clip unique de 2 à 30 secondes, avec son par défaut. Ouvrez la page du modèle pour générer en ligne.
• Facturation à la seconde : 480P à 0,0875 $/s, 720P à 0,18 $/s, 1080P à 0,36 $/s. 5 secondes en 480P ne coûtent que 0,4375 $.
• Deux pièges : la résolution doit être écrite en majuscules 480P / 720P / 1080P, et la valeur par défaut est 1080P ; Prime n'accepte pas de vidéo de référence.

Résultats d'abord

Texte-à-vidéo, 480P, 5 secondes, avec son (activez le son pour entendre la pluie, la circulation et le grésillement du gril) :

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.

Générer avec ce prompt → (5 secondes, 480P, 16:9, son activé)

wan3.0-video-prime, 480P, 5 secondes, avec son, 0,4375 $.

Vidéo à partir de référence : transmettez l'image d'une figurine de renard en céramique pour la faire bouger, en conservant son apparence.

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.

Générer avec ce prompt → (téléversez votre image de référence, 5 secondes, 480P, 9:16)

wan3.0-video-prime, image de référence, 480P, 5 secondes, 9:16, 0,4375 $.

curl : première vidéo

5 secondes en 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": "一只橘猫趴在洒满阳光的窗台上打哈欠，尾巴轻轻摆动，镜头缓慢推近，暖色调",
      "resolution": "480P",
      "duration": 5,
      "aspect_ratio": "16:9",
      "audio": false
    }
  }'

Après avoir reçu data.taskId, utilisez GET /v1/tasks/{taskId} pour vérifier que status vaut success, puis téléchargez output[0].url.

Python : soumission, interrogation, téléchargement

# pip install requests；先 export HIAPI_KEY=你的 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):
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    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)

# 参考生视频：让参考图里的产品动起来，480P 5 秒（$0.4375）
url = generate(
    prompt="让参考图里的香水瓶在黑色大理石上缓慢旋转，侧逆光扫过瓶身，镜头缓慢推近",
    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)

Trois modes d'utilisation

Usage	Ce qu'on transmet	Description
Texte-à-vidéo	Transmettre uniquement prompt
Première/dernière image	first_frame_url, éventuellement avec last_frame_url	Non combinable avec des éléments de référence
Vidéo à partir de références	reference_image_urls (10 maximum), reference_audio_urls (5 maximum, à utiliser avec des images), reference_file_urls ou reference_link_urls (1 maximum chacun, au choix)	Dans le prompt, désignez les éléments par Image1, Audio1 dans l'ordre

Le document et la page web de référence sont une particularité de Wan 3.0 : il est possible de fournir un PDF de charte de marque ou le lien d'une page produit au modèle pour qu'il produise la vidéo d'après les informations qu'il contient. La page web doit être accessible sans connexion.

Aperçu des paramètres

Paramètre	Valeurs	Description
prompt	chaîne, obligatoire	Décrire la scène, l'action, le cadrage, la lumière et le son
resolution	480P / 720P / 1080P, par défaut 1080P	Majuscules, détermine directement le prix
duration	entier de 2 à 30, par défaut 5	En secondes
aspect_ratio	adaptive 16:9 4:3 1:1 3:4 9:16, par défaut adaptive	adaptive choisit automatiquement selon les éléments et le prompt
audio	par défaut true	Piste audio synchronisée, sans frais supplémentaires
seed	0–2147483647	Seed fixe pour faciliter la reproduction
first_frame_url / last_frame_url	URL d'image	Première/dernière image
reference_image_urls etc.	Voir le tableau ci-dessus	Vidéo à partir de références

Calculons le coût

Durée	480P (0,0875 $/s)	720P (0,18 $/s)	1080P (0,36 $/s)
5 secondes	0,4375 $	0,90 $	1,80 $
10 secondes	0,875 $	1,80 $	3,60 $
30 secondes	2,625 $	5,40 $	10,80 $

Commencez par régler le prompt en 480P, puis passez en 720P ou 1080P une fois la version définitive. Si vous n'êtes pas pressé, la version standard Wan 3.0 (wan3.0-video) ne coûte que 0,08 $/s en 720P et accepte en plus les vidéos de référence. Voir les tarifs complets sur Tarifs de l'API Wan 3.0 Prime.

À 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"}, puis dédupliquez par taskId.
• Sauvegardez rapidement : output[0].url est un lien temporaire.
• Réessayez avec une clé d'idempotence : ajoutez l'en-tête Idempotency-Key ; une nouvelle tentative avec la même clé ne crée la tâche qu'une seule fois.
• Remboursement automatique en cas d'échec : seules les vidéos générées avec succès sont facturées.

Questions fréquentes

Pourquoi une erreur si je transmets 720p ?

La résolution doit être en majuscules. En minuscules, une erreur 400 est renvoyée : resolution: value must be one of '480P', '720P', '1080P'.

Peut-on transmettre une vidéo de référence ?

Prime ne le peut pas ; il n'accepte pas le paramètre reference_video_urls. Pour une vidéo de référence, passez à la version standard Wan 3.0 wan3.0-video.

Peut-on désactiver le son ?

Oui, avec audio: false. Il est activé par défaut, sans changement de prix.

Quelle différence entre Prime et la version standard Wan 3.0 ?

Les paramètres et les spécifications de sortie sont identiques ; Prime est une voie accélérée, la version standard propose aussi un palier 480P (0,04 $/s), mais 720P et 1080P coûtent plus du double à la seconde, et elle n'accepte pas les vidéos de référence.

Pour plus d'exemples de prompts, voir Exemples de prompts Wan 3.0 Prime, et pour la comparaison avec la génération précédente, voir Comment choisir entre Wan 3.0 et Wan 2.7. Vous pouvez aussi directement générer cette ruelle sous la pluie sur la page du modèle.