Introduction
Image vers vidéo pour Veo 3.1 : une première image, et éventuellement une dernière, en entrée ; un clip de 4 à 8 secondes en 720p avec son en sortie.
| Champ | Valeur |
|---|---|
| Entrée | Image |
| Sortie | Vidéo |
| Éditeur | |
| Durée du clip | 4, 6 ou 8 secondes |
| Résolution | 720p : 1280x720 (16:9) ou 720x1280 (9:16) |
| Formats d’image | 16:9, 9:16 |
| Fréquence d’images | 24 ips |
| Son | Généré avec chaque clip |
| Entrées | Texte ; première image avec dernière image facultative |
Fonctionnalités et points forts
Un plan construit dans l’ordre où vous l’avez écrit
Le prompt demandait l’ouverture de la coupole, l’apparition du télescope et un travelling de la caméra le long de la rambarde. En 4 secondes au format 9:16, l’obturateur est passé de fermé à entièrement ouvert, l’intérieur s’est éclairé d’ambre autour d’un télescope en laiton, et la caméra a avancé le long de la rambarde courbe, dans cet ordre.
Atterrir exactement sur la dernière image
Une première image d’une femme au télescope, de dos, et une dernière image où elle s’appuie sur la rambarde, les bras croisés. En 4 secondes, elle s’est retournée, s’est avancée jusqu’à la rambarde et a pris la pose finale, tandis que d’autres étoiles apparaissaient au-dessus de la coupole.
Quatre secondes suffisent pour une action
À partir d’une seule première image et du prompt « Il plie la carte et lève les yeux », il a plié la carte à deux mains en 4 secondes, mais il regardait encore vers le bas sur la dernière image. Prévoyez un temps par tranche de 4 secondes, ou choisissez 8 secondes pour en avoir deux.
Poursuivre un clip créé avec n’importe quel modèle
Nous avons envoyé un clip de 5 secondes réalisé avec un autre modèle et demandé 4 secondes de plus : « La route continue le long de la mer. » La nouvelle partie a repris le plan aérien sur la route côtière et suivi la voiture dans les virages. Nous avons récupéré un seul fichier de 9 secondes à la taille du clip source, et seules les 4 nouvelles secondes ont été facturées.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire. Décrivez ce qui bouge et comment, où va la caméra et ce que l’on entend, de la première image à la fin du clip. 1 caractères minimum · 4000 caractères maximum |
image_url | Oui | Obligatoire. L’image de départ (JPEG, PNG ou WebP). 1 caractères minimum |
last_image_url | Non | Facultatif. Une image de clôture sur laquelle le clip doit arriver. 1 caractères minimum |
aspect_ratio | Non | auto (par défaut) garde les proportions de votre première image ; 16:9 ou 9:16 la recadre à cette forme. Le prix reste le même. |
duration_seconds | Non | Le clip dure 4, 6 ou 8 secondes (8 si rien n’est précisé). Plus il est long, plus il coûte. |
Tarification
Facturé au clip, au prix de ses 4, 6 ou 8 secondes ; le format, le son et les images envoyées ne coûtent rien de plus. Les requêtes qui échouent ou sont refusées sont gratuites.
| Spécification | Prix |
|---|---|
| $1.44 / requête |
| $2.16 / requête |
| $2.88 / requête |
Cas d’utilisation
Le rendu final après un brouillon moins cher
Mettez au point le prompt, le cadrage et le rythme sur Veo 3.1 Fast à $0.36 ou sur Lite à $0.18 par clip de 4 secondes, puis envoyez la même requête à Veo 3.1 pour la version retenue. Les trois acceptent les mêmes champs.
Un plan de produit ou de lieu qui doit commencer et finir sur des images de tournage
Donnez l’image fixe d’ouverture et celle de fermeture, et décrivez le mouvement entre les deux. Dans notre test, le clip a atterri sur la dernière image en 4 secondes.
Des scènes de plus de 8 secondes
Générez les 8 premières secondes, puis poursuivez avec l’extension vidéo : la dernière image de votre clip ouvre un nouveau segment de 4 à 8 secondes, et vous récupérez un seul fichier assemblé. Le clip source, jusqu’à 60 secondes, n’est pas facturé.
Des clips verticaux avec son pour les publications sociales
Choisissez 9:16 pour obtenir un clip de 720x1280. Le son est généré avec l’image, si bien qu’un court format est prêt sans passage audio séparé.
Guide de prompt et conseils pratiques
Décrivez l’action dans l’ordre chronologique du plan
Lieu et lumière, sujet, action, mouvement de caméra, puis son. Notre prompt sur l’observatoire suivait cet ordre, et le clip a joué les temps dans le même ordre.
Mettre le son en scène comme un plan
Écrivez ce qu’on doit entendre : « Sound: wind over sand, the dome's motor ». Les paroles vont entre guillemets. Google précise que les répliques très courtes restent le point le plus délicat ; laissez donc quelques secondes à une scène parlée.
Adaptez l’action à la durée
Prévoyez une action claire par tranche de 4 secondes. Dans notre test de 4 secondes, « plie la carte et lève les yeux » n’est pas allé au-delà du pliage.
Réserver Veo 3.1 à la prise finale
À durée égale, Veo 3.1 coûte quatre fois Fast et huit fois Lite. Fixez la formulation et le cadrage sur un palier moins cher, puis lancez le rendu final une seule fois ici.
Présentation
Veo 3.1 Image vers vidéo démarre un clip 720p sur votre propre image et l’anime pendant 4, 6 ou 8 secondes, avec du son. Fournissez aussi une dernière image et le clip est guidé de la première vers la seconde. Google examine d’abord le prompt et les images ; les requêtes refusées échouent sans frais.
Choisir un mode Veo 3.1
| Vous avez | Utilisez |
|---|---|
| seulement une scène écrite | Veo 3.1 Texte vers vidéo |
| une image fixe pour ouvrir ou pour clore | Veo 3.1 Image vers vidéo (vous êtes ici) |
| des images que vous voulez poursuivre | Veo 3.1 Prolonger une vidéo |
Conseils pour le prompt
- Consacrez le prompt au mouvement et à la caméra ; l’image dit déjà ce qui est dans le cadre.
- Avec deux images, décrivez comment la scène passe de l’image d’ouverture à l’image de clôture.
- Réglez le format sur auto : le résultat gardera la forme de votre première image.
Besoin de plusieurs images de référence ? La référence vers vidéo est proposée sur la page de Veo 3.1 Fast.
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": "google/veo-3.1/image-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 8,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.