Guide de démarrage de P-Video 2 Pro Replace : remplacer les personnes d'une vidéo avec 1–2 photos

P-Video 2 Pro Replace est le modèle de remplacement de personnes de Pruna AI : à partir d'une vidéo source et de 1–2 photos de personnes, il conserve les mouvements, la caméra, le décor et le son de la vidéo d'origine, et remplace les personnes à l'écran par celles des photos. Cet article explique ce qu'il peut faire, comment l'appeler, comment le tarif est calculé, et quand il vaut mieux choisir un autre modèle.

Ce qu'il peut faire

• Remplacer une personne avec une vidéo et une photo : seuls la vidéo source video_url et les photos de personnes image_urls sont obligatoires, sans entraînement préalable d'une identité.
• Remplacer jusqu'à deux personnes : image_urls contient 1–2 photos (jpg, jpeg, png, webp), une photo par personne ; pour deux personnes, une photo chacune.
• Tout le contenu de la vidéo d'origine est conservé : mouvements, mouvements de caméra, décor et durée suivent la vidéo source. keep_audio est activé par défaut, la sortie contient le son de la vidéo d'origine ; défini à false, la sortie est sans son d'origine.
• Cinq paliers de résolution : 480p, 768p, 1080p, 2k, 4k, avec 768p par défaut, en conservant le rapport largeur/hauteur de la vidéo source.
• Prompt facultatif : prompt (1000 caractères maximum) décrit comment intégrer la personne des photos à l'image ; la génération fonctionne aussi sans prompt.

Exigences d'entrée

• Vidéo source : MP4, MOV ou WebM, d'une durée de 2 à 30 secondes. Les vidéos hors de cette plage sont refusées à la soumission, sans facturation ; pour des contenus plus longs, découpez-les d'abord en segments de 30 secondes maximum.
• Photos de personnes : 1–2, via des liens HTTPS.
• Le filtrage de sécurité du contenu est activé par défaut ; les contenus non conformes échouent et renvoient CONTENT_POLICY_VIOLATION, avec remboursement intégral.

Comment l'appeler

Soumettez une tâche asynchrone, puis interrogez le résultat à partir du taskId :

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "p-video-2-pro-replace",
    "input": {
      "video_url": "https://example.com/source.mp4",
      "image_urls": ["https://example.com/person.jpg"],
      "resolution": "768p",
      "keep_audio": true
    }
  }'

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

Une fois la tâche réussie, output contient l'adresse de la vidéo, dont la durée est identique à celle de la vidéo source.

Tarif

La facturation se fait selon la durée de la vidéo de sortie, les fractions de seconde inférieures à 1 seconde ne sont pas facturées ; le prix est identique avec 1 ou 2 photos :

• 480p : 0,0358 $/seconde
• 768p : 0,0715 $/seconde
• 1080p : 0,0858 $/seconde
• 2k : 0,1000 $/seconde
• 4k : 0,1286 $/seconde

Par exemple, une vidéo de 10 secondes en 768p coûte environ 0,72 $, et 30 secondes en 480p environ 1,07 $. À la soumission, 30 secondes sont prélevées d'avance ; une fois terminé, le règlement se fait selon la durée réelle de la vidéo, et le trop-perçu est remboursé. Les tâches échouées sont intégralement remboursées.

Comment mieux l'utiliser

• Avec une vidéo source où les personnes sont nettes et les mouvements fluides, et des photos où le visage de face est clair et l'éclairage uniforme, le remplacement est plus stable.
• Commencez par un court segment en 480p pour vérifier le résultat, puis produisez la version finale en haute résolution.
• Pour obtenir un résultat fixe, transmettez seed (entier de 0 à 2147483647) ; combiné à des entrées identiques, il aide à reproduire le résultat.

Quand choisir autre chose

• Pour changer le style visuel, le décor ou la caméra : ce modèle ne remplace que les personnes, tout le reste suit la vidéo source ; choisissez plutôt un modèle de montage vidéo.
• Sans vidéo source, avec seulement un portrait et un texte à dire : utilisez P-Video 2 Pro Avatar de la même famille pour générer une vidéo de présentation parlée.

Pour tester directement le résultat, vous pouvez téléverser une courte vidéo et une photo de personne dans le HiAPI Playground pour générer.