Alibaba
Wan 2.7 Video
wan2.7-video/image-to-video
Modèles de génération vidéo de la série WAN d'Ali, prenant en charge la génération à partir de texte, d'image et de références guidées ; les entrées multi-références permettent de maintenir la cohérence des personnages et des produits d'un plan à l'autre
Essayer wan2.7-video/image-to-video
Entrée
Créations
Voir toutes les créationsSortie
videoTarifs
wan2.7-video/image-to-video per second
| Spécifications | Prix unitaire |
|---|---|
| 720P | $0.100 |
| 1080P | $0.167 |
Présentation
wan2.7-video/image-to-video est un modèle de génération vidéo piloté par l'image de la série vidéo Alibaba WAN, accessible via l'interface unifiée de HiAPI.ai. Il génère une vidéo à partir d'une image de départ et prend également en charge le guidage par image de référence ou extrait de référence, permettant de contrôler le contenu visuel et les mouvements de caméra via le prompt. La résolution de sortie est sélectionnable entre 720P et 1080P, la durée par génération va de 2 à 15 secondes, et il accepte en entrée une combinaison de première image, dernière image, audio de guidage et extrait initial. Il convient aux développeurs souhaitant produire des clips courts à partir de ressources visuelles existantes, pour des créations publicitaires, des présentations e-commerce et des prévisualisations de storyboard.
Points clés
- Génération pilotée par l'image, avec contrôle des première et dernière images — il est possible de spécifier simultanément l'image de début et l'image de fin pour contraindre la composition d'ouverture et de fermeture du plan, réduisant les coûts de régénération liés à l'aléatoire.
- Extrait de référence et audio de guidage dans la génération — outre les première et dernière images, il est possible de fournir un extrait initial et un audio de guidage, afin que le résultat s'appuie sur un rythme de mouvement et une synchronisation son-image donnés.
- Durée et résolution ajustables — la durée par génération se règle entre 2 et 15 secondes, et la résolution de sortie est sélectionnable entre 720P et 1080P, pour s'adapter à différentes exigences de livraison.
Capacités
Génération image-vers-vidéo : génère une vidéo à partir d'une ou plusieurs images comme base visuelle, accompagnées d'un prompt textuel pouvant atteindre 5000 caractères, idéal pour transformer des ressources visuelles existantes en contenu animé.
Contrôle combiné première et dernière images : une requête peut spécifier à la fois l'image de début et l'image de fin, ou ajouter un extrait initial comme référence de départ, afin de délimiter les images d'ouverture et de fermeture du plan.
Entrée d'audio de guidage : il est possible de fournir un audio de guidage comme entrée média, pour que la vidéo générée corresponde au rythme du matériel sonore donné, réduisant l'étape de synchronisation en post-production.
Extension de prompt et prompt négatif : prompt_extend permet d'activer l'extension automatique du prompt, negative_prompt permet de déclarer les éléments visuels à éviter, et seed permet de reproduire un même résultat.
Résolution et durée paramétrables : la résolution de sortie et la durée sont toutes deux des paramètres de requête ; une même interface permet de basculer entre 720P/1080P et des durées de clip de 2 à 15 secondes selon le contexte.
Cas d'usage
- E-commerce et marques : générer une présentation animée à partir d'une image produit — fournir l'image principale du produit et les exigences de présentation pour produire un court clip vidéo du produit de quelques secondes, destiné aux pages de détail, aux diffusions en flux d'actualité et aux contenus pour réseaux sociaux.
- Équipes de contenu : transformer des images de personnage ou de scène en plans — utiliser une image de référence de personnage comme première image ou référence pour générer un court plan conforme à la description du storyboard, pour des courts-métrages, des prévisualisations d'animation et des propositions créatives.
- Équipes de design : plans de transition contraints par première et dernière images — fournir à la fois l'image de départ et l'image d'arrivée pour générer le segment de transition entre les deux, pour des génériques, des transitions et des présentations de solutions visuelles.
- Producteurs de contenu audio : génération visuelle pilotée par l'audio — fournir un matériel audio et une description visuelle pour générer un segment vidéo synchronisé au rythme sonore, pour des vidéos courtes musicales et des contenus de type présentation parlée.
Limites et conseils de sélection
La durée maximale par génération est de 15 secondes ; pour une narration plus longue, il faut générer par segments et assembler en post-production, la cohérence entre segments dépendant du contrôle des prompts et des ressources de référence. La résolution de sortie se limite à deux niveaux, 720P et 1080P ; des exigences de qualité supérieure nécessitent une évaluation distincte. Les entrées média sont limitées à trois au total, et chaque type ne peut apparaître qu'une seule fois. Si la tâche est principalement créative à partir de texte seul, sans base visuelle, envisagez un modèle texte-vers-vidéo de la même série ; pour des plans continus très longs, ce modèle n'est pas le choix approprié.
Questions fréquentes
Voir toutes les questions →-
Wan 2.7 Image to Video nécessite-t-il de téléverser une image ?
Oui. Actuellement, wan2.7-video/image-to-video est un pipeline de génération de vidéo à partir d'image : l'image d'entrée définit le sujet et la composition initiale, tandis que le prompt décrit les actions, les mouvements de caméra et les changements d'environnement.
-
Quelles durées et résolutions Wan 2.7 Image to Video prend-il en charge ?
Le contrat de requête HiAPI actuel prend en charge 2–15s, avec des résolutions de sortie de 720P et 1080P. Les valeurs disponibles sont celles indiquées dans le panneau de paramètres de la page et la documentation API.
-
Comment la génération d'image en vidéo Wan 2.7 est-elle facturée ?
Les tâches sont facturées en fonction de la durée de sortie et du niveau sélectionné. La page affiche le prix en temps réel selon l'unité monétaire globale, et le débit final est basé sur les enregistrements des tâches réussies.
-
Comment améliorer la stabilité du sujet en génération vidéo à partir d'images ?
Utilisez une image d'entrée avec un sujet clair, peu d'occlusions et une composition complète ; dans le prompt, décrivez d'abord l'action principale et le cadrage, puis énumérez l'apparence, les matériaux et les relations avec l'arrière-plan qui doivent être conservés. Pour le premier test, il est recommandé d'utiliser une durée plus courte.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : wan2.7-video/image-to-video
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour wan2.7-video/image-to-video et la route default — voir le tableau des paramètres ci-dessous.
seedintegerOptionnelmin 0max 2147483647Graine aléatoire utilisée pour contrôler le caractère aléatoire du résultat de génération ; prendre une valeur entière, les mêmes paramètres avec la même graine permettant de reproduire un résultat similaire.
mediaarrayRequisminItems 1maxItems 3
Tableau d'entrées multimédias contenant les différents éléments nécessaires à la génération vidéo à partir d'images ; les éléments sont des objets avec url et type, les types pris en charge étant first_frame, last_frame, driving_audio et first_clip, chaque type ne pouvant apparaître qu'une seule fois.
Array [ object ]
Éléments du tableau
urlstringRequisAdresse du média, sous forme d'URL publique, d'URL OSS ou de chaîne data URI base64 prise en charge.
typestringRequisType de ce média, sous forme de chaîne, identifiant son rôle dans le processus de génération (par exemple image de départ, image de fin, audio moteur, premier clip).
first_framelast_framedriving_audiofirst_clippromptstringRequismaxLength 5000Prompt textuel pour la génération vidéo à partir d'images, décrivant le contenu visuel et les effets dynamiques souhaités.
durationintegerOptionnelDéfaut: 5min 2max 15Durée de la vidéo générée, en secondes, sous forme de valeur entière, 5 par défaut.
watermarkbooleanOptionnelDéfaut: falseIndique s'il faut ajouter un filigrane à la vidéo générée, sous forme de booléen, false par défaut.
resolutionstringOptionnelDéfaut: "1080P"Résolution de la vidéo générée, sous forme de chaîne ; la facturation se fait à la seconde et le prix unitaire dépend de cette valeur, 1080P par défaut.
720P1080Pprompt_extendbooleanOptionnelDéfaut: trueIndique s'il faut activer l'extension du prompt ; une fois activée, le modèle étend automatiquement le prompt saisi, sous forme de booléen, true par défaut.
negative_promptstringOptionnelDéfaut: ""maxLength 500Prompt négatif décrivant le contenu que l'on ne souhaite pas voir apparaître dans la vidéo générée, chaîne vide par défaut.
callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-video/image-to-video",
"input": {
"media": "…",
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "1080P",
"prompt_extend": true,
"negative_prompt": ""
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "wan2.7-video/image-to-video",
input: {
"media": "…",
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "1080P",
"prompt_extend": true,
"negative_prompt": ""
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "wan2.7-video/image-to-video",
"input": {
"media": "…",
"prompt": "…",
"duration": 5,
"watermark": False,
"resolution": "1080P",
"prompt_extend": True,
"negative_prompt": ""
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
Voir tous les articles →-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
Modèles associés
Voir tous les modèles →Même type
-
Seedance 2.5 ByteDance $0.121 /seconde -
Kling AI Avatar Kuaishou -- -
HeyGen Avatar IV HeyGen $0.150 /seconde -
Grok Imagine 1.5 xAI $0.011 /seconde -
FLUX 3 Max Black Forest Labs $0.061 /seconde -
Wan 3.0 Video Alibaba $0.040 /seconde -
Kling 2.5 Kuaishou $0.060 /seconde -
Runway Gen 4.5 Runway $0.172 /seconde -
Seedance 2.0 ByteDance $0.017 /seconde -
Kling 4.0 Kuaishou $0.330 /seconde -
Gemini Omni 1.1 Flash Google $0.450 /vidéo -
MiniMax H3 MiniMax $0.072 /seconde
Même fournisseur
-
Wan 3.0 Video Alibaba $0.040 /seconde -
Z-Image Alibaba $0.008 /image -
Wan 2.6 Flash Alibaba $0.043 /seconde -
Qwen Image 2.1 Alibaba $0.020 /image -
Wan 2.7 Image Alibaba $0.035 /image -
Qwen Image 2.0 Alibaba $0.042 /image -
HappyHorse 1.1 Alibaba $0.160 /seconde -
HappyHorse 1.0 Alibaba $0.168 /seconde -
Qwen Image 3.0 Alibaba $0.036 /image -
Qwen Audio 3.0 TTS Alibaba $0.030 /1 000 caractères



