Guide : transformer des images en vidéo

La vidéo prend des minutes, pas des secondes : une intégration vidéo se construit donc autour des tâches et des webhooks, pas d’une requête unique qui attend. Ce guide parcourt les usages courants avec de vrais identifiants de modèles.

Animer une image

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "alibaba/wan-3.0/image-to-video",
    "input": {
      "image_url": "https://media.popnow.ai/movie/lighthouse.webp",
      "prompt": "Waves roll in slowly, clouds drift, the camera pushes gently toward the lighthouse",
      "resolution": "480p",
      "duration_seconds": 5
    },
    "callBackUrl": "https://your-app.example.com/hooks/popnow"
  }'

Vous recevez aussitôt un 202 avec un taskId. Quelques minutes plus tard, le webhook livre la tâche terminée, ou vous la lisez avec recordInfo. La vidéo se trouve dans output.assets[0], avec durationSeconds, width et height.

Ce que ça coûte

La plupart des modèles vidéo facturent à la seconde produite, et le tarif augmente avec la résolution. Pour alibaba/wan-3.0/image-to-video, c’est 6,75 crédits par seconde en 480p, 13,5 en 720p et 27 en 1080p : la requête ci-dessus réserve donc 34 crédits (5 × 6,75, arrondi au supérieur) et coûte autant si elle réussit.

• Commencez par la résolution la plus basse et une durée courte pendant que vous ajustez vos prompts, puis montez pour le rendu final.
• Demandez le prix exact à jobs/quote avant de l’afficher à un utilisateur.
• Une vidéo en échec ou expirée ne coûte rien.

Choisir la première et la dernière image

Beaucoup de modèles image vers vidéo acceptent aussi last_image_url. Le clip commence sur image_url et se termine exactement sur last_image_url : c’est ainsi qu’on fait une transformation ou une boucle fluide (avec la même image aux deux bouts).

Vidéo de référence : garder un personnage ou un produit cohérent

Les modèles reference-to-video construisent une nouvelle scène autour d’une ou plusieurs images de référence (et, pour certains, d’une vidéo ou d’un audio de référence) au lieu d’animer une première image donnée :

{
  "model": "minimax/h3/reference-to-video",
  "input": {
    "prompt": "The same lighthouse at night, its beam sweeping over a calm sea while the camera circles slowly",
    "reference_image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"],
    "duration_seconds": 6
  }
}

La façon de désigner les références dans le prompt varie selon le modèle ; les descriptions de champs de sa page de référence l’expliquent.

Allonger un clip

Les modèles video-extend prolongent un clip existant à partir de sa dernière image. Envoyez le clip dans video_url et décrivez la suite :

{
  "model": "minimax/h3/video-extend",
  "input": {
    "video_url": "https://media.popnow.ai/showcase/moon-picnic-loop.mp4",
    "prompt": "The camera keeps drifting right as the picnic blanket ripples in the breeze"
  }
}

Les modèles d’extension qui raccordent les clips renvoient deux fichiers : d’abord la vidéo assemblée (role: "video"), puis la nouvelle partie seule (role: "segment").

Le son

Les modèles dotés de generate_audio ajoutent une bande-son au clip ; la désactiver peut faire baisser le prix sur certains modèles. Pour sonoriser une vidéo existante, utilisez popnow/foley-v1/video-to-audio, qui renvoie la même vidéo avec un son généré.

Des prompts qui marchent en vidéo

Décrivez le mouvement, pas seulement la scène : ce qui bouge, à quelle vitesse, et ce que fait la caméra. « La caméra avance lentement pendant que le personnage se tourne vers la lumière » donne quelque chose à faire au modèle ; « un beau phare », non. L’image dit déjà à quoi ressemblent les choses : consacrez les mots à ce qui change.

Un schéma pour la production

1. Envoyez ou enregistrez l’image source, et conservez son URI popnow://.
2. Demandez un devis, affichez le prix, puis appelez createTask avec un Idempotency-Key dérivé de votre propre identifiant de travail et une callBackUrl.
3. Dans le webhook, vérifiez la signature, accusez réception, puis téléchargez la vidéo dans votre propre stockage.
4. Une fois par jour, listez les tâches récentes avec GET /api/v1/jobs et lisez celles dont le webhook n’est jamais arrivé.

Le reste est dans la checklist de mise en production.