Blog

Guide d'utilisation

Mettre en place un flux de travail de vidéo courte image-vers-vidéo avec Wan2.7 via l'API HiAPI

Guide pour développeurs : choix de l'image de départ, prompts de cadrage et de rythme, format d'image, durée et génération en lot

Nov 9, 2026
Illustration de couverture géométrique plate sur fond beige, avec des bandes horizontales en escalier rouge terre décroissant de gauche à droite, destinée au guide du flux de travail vidéo Wan2.7.
Sur cette page

Pourquoi la génération image-vers-vidéo convient à la production de vidéos courtes

La vidéo courte est un métier où le volume prime. Un extrait seul est rarement le livrable final ; le vrai livrable est une série d'extraits partageant le même rendu, le même rythme et la même fréquence de publication. Ce besoin façonne davantage le choix des outils que n'importe quel indicateur de qualité de sortie pris isolément.

La génération image-vers-vidéo y correspond très bien parce qu'elle fait de l'image fixe le principal signal de contrôle. Plutôt que de décrire toute la scène en texte et d'espérer que le modèle tombe exactement sur la composition imaginée, vous confiez au modèle une image déjà validée : le sujet est là où vous l'avez placé, le cadrage est celui que vous avez conçu, la lumière tombe comme vous l'avez réglée. L'étape de génération porte alors sur le mouvement — comment le sujet se déplace, comment la caméra bouge, à quelle vitesse la caméra respire — au lieu de créer une scène à partir de rien.

Cette répartition des rôles compte pour une équipe. L'image fixe peut être produite, validée et approuvée par des personnes douées pour la composition, avec n'importe quel pipeline dont vous disposez déjà. Le mouvement est un problème plus petit et plus facile à tester. Quand un extrait ne convient pas, vous pouvez généralement déterminer si le problème vient de l'image ou du prompt, et c'est précisément la dichotomie de diagnostic que vous voulez lorsque vous produisez des dizaines d'extraits par semaine.

Le pipeline de bout en bout sur HiAPI est volontairement ennuyeux :

  1. Créer ou choisir une image fixe de départ pour chaque plan.
  2. Rédiger le prompt de cadrage décrivant l'action du sujet, le mouvement de caméra et le rythme.
  3. Envoyer l'image fixe et le prompt avec un format d'image et une durée fixes à la route wan2.7-video/image-to-video.
  4. Collecter les extraits renvoyés dans une file de validation.
  5. Accepter, modifier le prompt ou recadrer, puis publier.

Tout l'intérêt de ce guide est de rendre chacune de ces étapes reproductible, car la valeur d'un pipeline de vidéos courtes ne réside pas dans un extrait brillant — mais dans la possibilité de refaire demain le même processus avec de nouvelles images et d'obtenir des résultats comparables.

L'image fixe comme unité de travail

Traitez l'image fixe comme l'artefact dont vous gérez les versions. En pratique, cela signifie nommer les images de façon déterministe et conserver ensemble les images approuvées et les prompts utilisés avec elles. Si vous voulez ensuite essayer différentes versions du même plan, ne changez qu'une variable à la fois : le prompt, ou l'image, jamais les deux en même temps.

Ce que le modèle décide à votre place et ce qu'il ne décide pas

Le format d'image et la durée sont décidés par vous, et non des propriétés qui émergent spontanément du prompt. Verrouillez-les tôt. Tout ce qui suit en aval — la façon dont vous cadrez l'image fixe, la formulation du rythme, le montage de l'extrait pour la plateforme — suppose que ces deux valeurs sont déjà fixées.

D'une image fixe unique à un extrait publiable : chaque étape progresse le long de la même structure de bandes.

Choisir l'image de départ

L'image de départ fait la majeure partie du travail. Si elle est mal choisie, aucun réglage de prompt ne pourra totalement sauver l'extrait, et vous passerez de nombreuses itérations à poursuivre un problème qui vient en réalité de l'image fixe. Avant de dépenser la moindre génération, filtrez les images candidates avec une courte liste de critères explicites.

Composition et cadrage du sujet

L'image que vous choisissez doit être composée pour le format d'image que vous livrerez, et pas seulement recadrée à ce ratio. Si le sujet est proche du bord dans l'image fixe, attendez-vous à ce que le modèle n'ait presque aucun espace pour déplacer la caméra sans pousser le sujet hors du cadre. Laissez de la place pour que le mouvement se produise : espace de dégagement dans la direction du panoramique prévu, espace au-dessus d'un sujet susceptible de monter, éléments de premier plan capables de créer de la parallaxe.

Vérifiez le cadrage au format d'image de livraison, et non au format d'image source. Une image qui paraît équilibrée en carré peut perdre son sujet lorsqu'elle est comprimée dans un cadre vertical haut.

Espace au-dessus du sujet et cohérence du cadrage

Si une série d'extraits doit être montée ensemble ou publiée en séquence, gardez l'espace au-dessus des sujets cohérent d'une image à l'autre. Une incohérence d'espace au-dessus du sujet se lit comme un montage bâclé, même si chaque extrait pris isolément est correct. Définissez une convention — par exemple un écart fixe entre le haut de la tête du sujet et le bord supérieur du cadre — et appliquez-la à chaque image fixe du groupe.

Direction de la lumière et stabilité des ombres

L'éclairage détermine la crédibilité du mouvement. Une lumière forte et directionnelle avec des ombres nettes donne au modèle une structure sur laquelle s'appuyer ; une lumière plate et sans ombre produit souvent un mouvement qui donne l'impression de glisser plutôt que de se déplacer. Privilégiez les images où la direction de la lumière est sans ambiguïté, et évitez les images fixes où les ombres pourraient tomber dans deux directions — cette ambiguïté se manifeste souvent par du scintillement.

Un statisme qui appelle le mouvement

Une bonne image de départ suggère ce qui va suivre. Un sujet en pleine action, un regard tourné hors du cadre, un corps incliné vers un espace ouvert — tout cela donne au modèle une direction naturelle de continuation. Un portrait parfaitement symétrique, face à l'objectif et statique, est le plus difficile à animer naturellement, car il n'a aucune direction implicite.

Propreté de l'image

Avant de générer, examinez l'image fixe en pleine résolution pour repérer les défauts : traînées sur les bords, mains incohérentes, textures répétées, texte qui se déformera visiblement dès qu'il commencera à bouger. Un petit défaut dans une image fixe devient un défaut évident dans l'extrait. Réparer ou régénérer l'image coûte presque toujours moins cher que de retirer une nouvelle vidéo.

Comparaison de trois images de départ candidates sur le cadrage du sujet, l'espace au-dessus du sujet et la direction de la lumière.

Rédiger les prompts de cadrage et de rythme

L'erreur de prompt la plus courante en image-vers-vidéo consiste à écrire le prompt comme une description de scène. La scène est déjà déterminée — c'est l'image. Ce que le modèle attend de vous, ce sont des instructions de caméra : ce qui bouge, comment, et à quelle vitesse.

Structurer le prompt en trois propositions

Les prompts qui produisent régulièrement des extraits exploitables couvrent généralement trois choses, dans l'ordre :

  • Action du sujet — ce que fait le sujet, avec une description physique concrète.
  • Mouvement de caméra — ce que fait la caméra, sous forme d'un mouvement unique et net.
  • Rythme — la vitesse à laquelle l'action se déroule dans l'extrait.

Par exemple, plutôt que de décrire une personne dans une pièce, décrivez le sujet qui tourne la tête vers la fenêtre, une caméra qui avance lentement, une action qui se déploie progressivement sur toute la durée. Chaque proposition correspond à quelque chose que le modèle peut exécuter.

Garder un seul mouvement de caméra

Un seul mouvement par plan. Avance avant, panoramique ou dérive à l'épaule — choisissez-en un. Les prompts qui demandent à la fois d'avancer, de tourner autour et de zoomer produisent souvent un mouvement trouble et indécis. Si un plan nécessite deux mouvements, c'est qu'il s'agit de deux plans.

Rythmer pour la plateforme, pas pour le modèle

Le public des vidéos courtes fait défiler vite. Un extrait qui consacre la majeure partie de sa durée à établir une scène statique fera partir les spectateurs avant que quoi que ce soit ne se produise. Écrivez le rythme explicitement : placez un peu de mouvement dans les premiers instants, puis laissez la caméra s'installer dans l'action principale. Les mots qui transmettent la vitesse — progressivement, vivement, continuellement, en se stabilisant peu à peu — sont plus utiles qu'une longue liste d'adjectifs.

Décrire le mouvement, pas l'émotion

Les mots émotionnels sont peu coûteux et largement ignorés. Les descriptions physiques ne le sont pas. Privilégiez les affirmations observables sur les corps, les objets et la caméra plutôt que les traits abstraits. Si vous voulez un rendu émotionnel particulier, obtenez-le par l'action et le rythme, pas par des mots comme « cinématographique ».

Gérer les versions de prompts comme du code

Conservez chaque prompt avec l'identifiant de l'image, le format d'image et la durée dans un dépôt de code ou une base de données. Quand un extrait fonctionne bien, vous voudrez savoir quelle combinaison l'a produit, afin de pouvoir ensuite relancer cette combinaison sur tout un lot d'images similaires.

Définir le format d'image et la durée

Le format d'image et la durée sont les deux paramètres les plus susceptibles de saboter discrètement un flux de travail, car aucun n'apparaît dans le prompt et tous deux changent ce qui compte comme un bon résultat. Décidez-les une fois pour toutes pour chaque format de sortie, puis traitez-les comme des constantes.

Choisir le format d'image

Choisissez le ratio réellement affiché par votre plateforme cible et composez votre image fixe pour lui. La conséquence pratique : vous ne devez pas réutiliser la même image entre vertical et horizontal sans recomposer — un cadrage adapté au format haut convient rarement au format large. Si vous avez besoin des deux, maintenez deux jeux d'images issus de la même prise de vue, chacun composé pour son propre ratio.

Une fois choisi, enregistrez ce ratio avec chaque requête. Un mélange de ratios dans un lot terminé signifie généralement que quelqu'un a modifié la valeur par défaut, plutôt que pris une décision.

Choisir la durée

Un extrait de vidéo courte est court. Prévoyez une durée adaptée au format : assez longue pour accomplir une action unique et claire, assez courte pour qu'il n'y ait rien d'inutile. Comme HiAPI facture la génération image-vers-vidéo selon la durée de sortie, un extrait trop long coûte plus cher et rend la validation moins agréable — les spectateurs voient rarement la fin d'un extrait qui n'a plus rien à dire.

Rédigez le prompt comme s'il devait remplir la durée choisie. Une action décrite plus longue que l'extrait produit une coupure abrupte en pleine action ; une action qui s'achève en une petite fraction de la durée laisse un vide à la fin. Faites correspondre intentionnellement la formulation du rythme à la longueur.

Fixer les deux avant d'étendre

C'est la règle de processus la plus importante de ce guide. Le réglage des prompts n'a de sens qu'à format d'image et durée fixes, car les deux changent la façon dont le mouvement est perçu. Si vous réglez un prompt pour une durée, puis raccourcissez la sortie, chaque prompt que vous avez approuvé devient une supposition non testée. Verrouillez ce couple de paramètres, réglez pour lui, et ne le modifiez que dans le cadre d'un événement de réglage volontaire.

Paramètres à consigner à chaque exécution

Conservez une petite fiche pour chaque lot : format d'image, durée, route du modèle, identifiant du groupe d'images, version du prompt. Cette fiche de quatre champs suffit généralement à reconstituer, des mois plus tard, pourquoi un extrait ressemble à ce qu'il est, sans avoir à fouiller les journaux.

Générer en lot sur HiAPI

Une fois le groupe d'images et le schéma de prompts approuvés, la génération devient mécanique. L'objectif est un petit script capable de dérouler les requêtes et de collecter les résultats de façon déterministe, afin que vous puissiez l'exécuter selon un planning plutôt qu'à la main.

Identifiants et configuration

Conservez les identifiants de l'API dans des variables d'environnement, jamais dans un script ou un dépôt. Lisez le point de terminaison et la route du modèle depuis la configuration, afin de pouvoir plus tard pointer le même script vers une route différente sans modifier le chemin de code.

export HIAPI_API_KEY="your-key-here"

Une requête exécutable

La route de ce flux de travail est wan2.7-video/image-to-video. La requête minimale contient l'image de départ, le prompt de cadrage, le format d'image et la durée :

curl -X POST "https://api.hiapi.ai/v1/video/generations" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-video/image-to-video",
    "image": "https://your-cdn.example/frames/shot-014.png",
    "prompt": "Subject turns toward the window; slow push-in; gradual motion settling over the clip.",
    "aspect_ratio": "9:16",
    "duration": 5
  }'

Avant de boucler quoi que ce soit, exécutez-la une fois sur une image connue comme bonne. Une seule requête réussie confirme vos identifiants, le nom de la route et la structure de la charge utile.

Parcourir un ensemble d'images

La génération en lot, c'est la même requête répétée, avec simplement un image et un prompt associé différents. Organisez les entrées sous forme de liste d'enregistrements, chaque enregistrement portant l'URL de l'image, son prompt et un nom de sortie que vous contrôlez. Itérez, soumettez, et consignez les identifiants renvoyés sur l'enregistrement d'entrée.

Deux règles pratiques pour la boucle :

  • Limitez la concurrence. Envoyer toutes les requêtes d'un coup est le moyen le plus rapide d'atteindre les limites de débit et de ne plus savoir quelle réponse correspond à quelle entrée. Un pool de travail modéré avec des tentatives de reprise est plus fiable qu'une rafale.
  • Consignez requêtes et résultats ensemble. Pour chaque génération, conservez durablement l'URL de l'image, le prompt, le format d'image, la durée et la référence de l'extrait renvoyé. Sans cela, vous ne pouvez ni reproduire un bon extrait ni expliquer un mauvais.

Collecter les sorties

Téléchargez les extraits dans une arborescence de dossiers déterministe, indexée par identifiant d'image et version de prompt, puis remettez le dossier à la validation. Garder un schéma de nommage stable signifie que votre étape de validation se résume à lister un répertoire, plutôt qu'à un travail de rapprochement.

Idempotence lors des relances

Attribuez un hachage stable à chaque couple image-prompt et ignorez les couples déjà générés, sauf si vous retirez délibérément un nouvel extrait. Régénérer tout un lot pour combler trois lacunes est la façon la plus courante pour une équipe de gaspiller son quota dans un pipeline image-vers-vidéo.

Un identifiant et une route de modèle transforment une pile d'images de départ en requêtes parallèles déployées en éventail, les extraits étant collectés dans un même dossier de sortie.

Valider et itérer sur les sorties

La validation est une étape de production, pas une formalité. L'objectif est de classer rapidement chaque extrait dans l'un de trois résultats — accepter, modifier le prompt ou recadrer — pour que le lot continue d'avancer.

Une courte liste de vérification

Faites passer chaque extrait renvoyé par les mêmes contrôles, dans l'ordre :

  1. Fidélité à l'image de départ — l'instant d'ouverture correspond-il à l'image fixe que vous avez approuvée ? S'il dérive immédiatement, le problème vient généralement de l'image, pas du prompt.
  2. Plausibilité du mouvement — le déplacement du sujet respecte-t-il la façon dont les corps et les objets bougent réellement ? Surveillez les glissements, les déformations de membres, les objets qui changent de forme.
  3. Discipline de caméra — la caméra exécute-t-elle le mouvement unique que vous avez demandé, ou dérive-t-elle ?
  4. Adéquation du rythme — l'action s'achève-t-elle dans la durée, sans queue superflue ni coupure en pleine action ?
  5. Détection de défauts — vérifiez les bords, les mains, les visages, le texte en arrière-plan et toute zone à détails fins.
  6. Contrôle du format — le format d'image est-il correct, et le sujet reste-t-il dans les marges de sécurité des superpositions d'interface de la plateforme ?

Décisions de tri

  • Accepter si l'extrait passe les six contrôles, ou n'échoue que sur des aspects invisibles à la taille de livraison.
  • Modifier le prompt si l'image est bonne mais que le mouvement, la caméra ou le rythme ne vont pas. Modifiez une seule proposition du prompt et régénérez.
  • Recadrer si les défauts de mouvement remontent à une ambiguïté dans l'image fixe — direction de lumière floue, cadrage maladroit, ou sujet sans mouvement implicite.

Ne changez qu'une variable par itération. Changer à la fois l'image et le prompt ne vous dira pas quelle correction a fonctionné.

Une validation peu coûteuse vaut mieux qu'un plan parfait

Pour la production de vidéos courtes à grande échelle, une validation rapide réussite/échec sur de nombreux extraits vaut mieux que le polissage d'un seul extrait par de multiples relances. Validez à la taille à laquelle le public verra réellement l'extrait, pas en pleine résolution, et ne zoomez que sur les extraits que vous êtes sur le point d'accepter. Cela rend l'étape de validation proportionnelle à la taille du lot, et non à votre anxiété.

Renvoyer les constats en retour

Notez en continu quels schémas de prompts et quelles qualités d'image sont corrélés au taux d'acceptation. Après quelques lots, cela devient un style interne — un petit ensemble de propositions de prompts et de règles de cadrage qui produisent régulièrement des extraits que les validateurs approuvent sans longues discussions.

Pièges à éviter

La plupart des projets image-vers-vidéo qui stagnent en production échouent pour des raisons de processus plutôt que de modèle. Voici les plus récurrents.

Régler les prompts sur une cible mouvante

Changer la durée ou le format d'image en cours de réglage invalide toutes les comparaisons déjà faites. Fixez d'abord les deux, puis réglez. Si les parties prenantes demandent un autre format, traitez-le comme un nouveau cycle de réglage avec ses propres prompts approuvés, et non comme un simple ajustement de paramètres.

Traiter l'image fixe comme une réflexion après coup

Les équipes qui génèrent rapidement une image puis consacrent tout leur effort au prompt atteignent vite un plafond. L'image est le signal de contrôle. Réservez un vrai temps de validation aux images fixes et refusez les images faibles avant qu'elles n'entrent en génération.

Remplacer les instructions de caméra par une description de scène

Les prompts remplis d'émotion et de contexte, mais dépourvus d'action physique, produisent des extraits jolis où il ne se passe rien. Chaque prompt doit indiquer ce qui bouge et à quelle vitesse.

Concurrence illimitée et journaux manquants

Envoyer des requêtes en rafale et jeter les identifiants de réponse rend un lot irrécupérable. Consignez entrées et sorties ensemble, limitez le nombre de threads de travail et rendez les relances idempotentes.

Absence de registre d'approbation

Si vous ne pouvez pas indiquer l'image, le prompt, le ratio et la durée exacts qui ont produit un extrait accepté, vous ne pouvez pas le répéter. Le coût apparaît la première fois que vous devez étendre une série et que vous réalisez que le meilleur extrait n'est pas reproductible.

Surproduire pour combler de petits manques

Relancer tout un lot parce que trois extraits ont échoué gaspille du temps et du budget. Suivez l'état de chaque entrée et ne régénérez que les parties manquantes.

Ignorer les zones de sécurité des plateformes

Un extrait techniquement correct mais dont le sujet tombe sous les superpositions d'interface de la plateforme se lit comme défectueux. Composez les images fixes avec les mêmes marges de sécurité que pour tout autre asset que vous livrez.

Rien de tout cela n'est exotique. Ce n'est que la discipline ordinaire d'un pipeline de production, appliquée à un modèle qui la récompense.

Commencez par une image approuvée et un prompt, exécutez de bout en bout sur la route wan2.7-video/image-to-video, puis étendez la boucle à un lot complet.

Articles similaires

Voir tous les articles →

Commencez avec des artefacts IA persistants

Obtenez votre clé API et appelez des modèles d'image, de vidéo et d'audio via une API unique basée sur les tasks.

Lire la documentation de l'API