Introduction
PixVerse V6 Image vers vidéo anime une première image en clip de 1 à 15 secondes, en 360p, 540p, 720p ou 1080p. Ajoutez last_image_url et le clip passe de la première image à la dernière. Le prompt est obligatoire et décrit ce qui se passe. Le clip garde le ratio d’image de votre première image. Les images sont en JPG, JPEG, PNG ou WebP, jusqu’à 20 Mo chacune. PixVerse contrôle les prompts et les images avant la génération ; les requêtes qu’il refuse échouent et ne sont pas facturées.
Choisir un mode PixVerse V6 selon le matériau de départ
| Ce que vous avez au départ | Mode |
|---|---|
| une scène écrite | PixVerse V6 Texte vers vidéo |
| une première image, et éventuellement une dernière image | PixVerse V6 Image vers vidéo (vous êtes ici) |
| des photos de personnes, d’objets ou de lieux à distribuer | PixVerse V6 Référence vers vidéo |
| un clip que vous voulez poursuivre | PixVerse V6 Extension vidéo |
| un prompt ou une image, et vous voulez une qualité d’image supérieure | PixVerse V6 Max |
| une photo et un gabarit thématique prêt à l’emploi, sans prompt à écrire | PixVerse V6 Effects |
Fonctionnalités et points forts
Première image, dernière image facultative
image_url définit le début et last_image_url la fin. Dans notre test, une femme en manteau couleur rouille à l’entrebâillement d’un dôme d’observatoire blanc (première image), puis la même femme appuyée en arrière sur la rambarde, les bras croisés (dernière image), sont devenues un seul mouvement : elle se retourne, longe la rambarde, se penche en arrière et croise les bras, et le clip se termine sur la dernière image.
La forme suit votre image
Il n’y a pas de champ de ratio d’image. Une image en portrait donne un clip en portrait, une image large un clip large.
Un interrupteur multi-plans
shot_type vaut single par défaut. Mettez multi pour laisser le modèle découper le clip en plusieurs plans. Il ne peut pas être combiné avec une dernière image.
Le son quand vous le voulez
generate_audio est désactivé par défaut. Activé, le modèle génère l’ambiance, les effets, la musique et les dialogues que vous écrivez entre guillemets. Le son coûte plus cher à la seconde.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, de 3 à 5 000 caractères. Décrivez ce qui se passe entre les images et après elles : l’action et la caméra. 3 caractères minimum · 5000 caractères maximum |
image_url | Oui | Obligatoire. La première image, en JPG, JPEG, PNG ou WebP, jusqu’à 20 Mo. |
last_image_url | Non | Dernière image facultative, mêmes formats et même taille. Avec elle, le clip passe de la première image à la dernière. |
resolution | Non | 360p, 540p, 720p (par défaut) ou 1080p. Les résolutions plus élevées coûtent plus cher à la seconde. |
duration_seconds | Non | Secondes entières, de 1 à 15 (par défaut 5). Le prix se calcule à la seconde. |
generate_audio | Non | Désactivé par défaut. Activé, il génère le son avec l’image : ambiance, effets, musique et dialogues écrits entre guillemets. Valeur par défaut: |
shot_type | Non | single (par défaut) ou multi. multi laisse le modèle découper le clip en plusieurs plans ; il ne peut pas être combiné avec une dernière image. |
seed | Non | Nombre entier facultatif de 0 à 2147483647. Permet de comparer une seule modification à la fois ; ne garantit pas des images identiques. |
Tarification
Facturé à la seconde de sortie. La résolution et l’interrupteur audio modifient le prix par seconde ; le type de plan et la graine ne le modifient pas. Les requêtes échouées ou refusées ne sont pas facturées.
| Résolution | Générer l’audio: Non | Générer l’audio: Oui |
|---|---|---|
| $0.0222 / seconde | $0.0311 / seconde |
| $0.0311 / seconde | $0.04 / seconde |
| $0.04 / seconde | $0.0533 / seconde |
| $0.08 / seconde | $0.1022 / seconde |
Cas d’utilisation
Donner vie à une image fixe
Un portrait, une scène de rue ou une image extraite d’un clip précédent. Décrivez ce qui se passe ensuite : la personne, la tenue et le décor viennent de l’image.
Passer d’une pose à l’autre
Donnez une dernière image différente de la première et laissez le modèle remplir le mouvement, comme dans notre exemple de dôme d’observatoire.
Garder un personnage d’un plan à l’autre
Enregistrez une image d’un clip et utilisez-la comme première image du suivant pour garder une personne et un décor d’un plan à l’autre.
Guide de prompt et conseils pratiques
Décrivez le mouvement, pas l’image
L’image montre déjà à quoi ressemble tout. Consacrez le prompt à l’action, au mouvement de caméra et, si le son est activé, au son.
Gardez les deux images cohérentes
Utilisez la même personne et le même décor dans la première et la dernière image. Des images qui ne concordent pas ne laissent au modèle aucun mouvement naturel entre elles.
Laissez à chaque action le temps d’exister
Dans notre test sur la station-service, le prompt listait une lampe, une carte, une marche et un camion qui passe ; l’homme a plié la carte, l’a rangée et a marché vers la voiture, et le camion aux phares allumés est apparu dans la dernière seconde du clip de 5 secondes. Demandez moins d’actions, ou ajoutez des secondes, si une action tardive compte.
Comparez avec une graine
seed permet de comparer les générations pendant que vous modifiez une seule chose à la fois. Elle ne garantit pas des images identiques.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pixverse/v6/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
