Introduction
Référence vers vidéo pour Veo 3.1 Fast : une à trois images de référence et un prompt en entrée, un clip de 8 secondes en 720p avec son en sortie.
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| Sortie | Vidéo |
| Éditeur | |
| Durée du clip | 4, 6 ou 8 secondes ; toujours 8 avec des images de référence |
| 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 | Prompt ; première image et dernière image facultative ; 1 à 3 images de référence |
Fonctionnalités et points forts
Placer la personne d’une photo dans le décor d’une autre
L’image 1 était un homme en veste en jean dans une station-service, l’image 2 un observatoire de nuit. Le prompt demandait à l’homme de la première image de marcher jusqu’à l’observatoire, de frapper à la porte et de faire signe. En 8 secondes, il a fait les trois, avec le même visage, les mêmes cheveux et la même veste. Une femme qui figurait aussi sur l’image 2 n’est pas apparue.
Un travelling avant continu
À partir d’une seule première image et de « Lent travelling avant », la caméra s’est rapprochée sans coupe pendant 8 secondes, d’un plan large de la coupole à un plan rapproché. Elle s’est détournée du télescope, a croisé les bras et a souri pendant que les étoiles apparaissaient.
Une caméra qui suit le brief
Le même prompt sur l’observatoire que nous avions lancé sur Veo 3.1 a donné un plan de 4 secondes en 16:9 sur une passerelle surélevée menant à la coupole. La caméra a avancé comme demandé, et le télescope en laiton a pivoté vers l’ouverture.
Comparer les paliers avant de choisir
Nous avons envoyé le même prompt de bateau de papier en deux phrases à Veo 3.1 et à Fast. Veo 3.1 a filmé au ras de l’eau, avec des roseaux au premier plan ; Fast a centré le bateau sur le reflet du soleil, avec des ondulations qui s’étendent autour. Testez quelques prompts sur les deux avant de choisir un palier pour un projet.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire. Nommez ce qu’il faut reprendre de Image 1, Image 2 et Image 3, puis l’action et le mouvement de caméra. 1 caractères minimum · 4000 caractères maximum |
reference_image_urls | Oui | Obligatoire : 1 à 3 images des personnes, produits ou lieux à conserver. Dans le prompt, appelez-les Image 1, Image 2 et Image 3, dans l’ordre où vous les envoyez. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | 16:9 (par défaut) ou 9:16. Ne change pas le prix. |
duration_seconds | Non | Fixé à 8 secondes dans ce mode. |
Tarification
Facturé comme un seul clip de 8 secondes. Le nombre d’images de référence et le format d’image ne changent pas le prix. Une tâche échouée ou refusée ne coûte rien.
| Spécification | Prix |
|---|---|
| $0.72 / requête |
Cas d’utilisation
Séries de publicités et de posts sociaux
Le prix par clip est assez bas pour produire d’un coup tout un lot de variantes 9:16 : dix clips de 4 secondes coûtent $3.60, son compris.
Le même personnage ou produit sur plusieurs clips
Envoyez de 1 à 3 images de référence et désignez-les dans le prompt comme Image 1, Image 2 et Image 3. Dans notre test, le visage et la veste de l’image 1 se sont retrouvés dans une nouvelle scène.
Des storyboards qui commencent et finissent sur des images de tournage
L’image vers vidéo prend une première image et une dernière image facultative : chaque plan d’une séquence peut ainsi commencer et finir là où vous l’aviez prévu.
Des scènes de plus de 8 secondes
Prolongez un clip avec l’extension vidéo : sa dernière image ouvre un nouveau segment de 4 à 8 secondes, facturé au prix de l’image vers vidéo, et la source n’est pas facturée.
Guide de prompt et conseils pratiques
Désignez les références par leur numéro
Citez-les dans l’ordre de téléversement : « l’homme de l’image 1 », « l’observatoire de l’image 2 ». Précisez le rôle de chacune : les images fixent le rendu, le prompt fixe l’action.
Recadrez les références sur ce que vous voulez
Utilisez un seul sujet par image lorsque c’est possible. Fast a exclu une seconde personne de notre image de référence, mais d’autres modèles peuvent tout intégrer.
Décrivez la caméra et le son
Nommez un mouvement, comme « Lent travelling avant » ou « Plan moyen à l’épaule », et ajoutez une ligne du type « Son : pas sur le gravier, un coup métallique ». Mettez les paroles entre guillemets.
Itérer en 4 secondes, finir en 8
À $0.36, un clip de 4 secondes est assez économique pour tester plusieurs formulations. Quand l’une fonctionne, rendez-la en 8 secondes ou envoyez la version finale à Veo 3.1. Les clips de référence font 8 secondes d’emblée, $0.72.
Présentation
Veo 3.1 Fast Référence vers vidéo transporte une personne, un produit ou un lieu issus de jusqu’à trois images dans un nouveau clip 720p de 8 secondes avec son. Le Veo 3.1 de Google accepte lui aussi des images de référence ; sur SpicyAPI, le mode est proposé sur Fast et Lite, ce qui fait de Fast le niveau Veo à choisir quand un même sujet doit apparaître clip après clip. Google examine d’abord le prompt et les images, et une requête qu’il refuse échoue sans frais.
Les autres modes de Veo 3.1 Fast
- Seulement une idée en mots ? Texte vers vidéo écrit la scène à partir de votre prompt seul.
- Vous partez d’une image fixe ? Image vers vidéo anime une première image et peut s’achever sur une dernière.
- Vous avez déjà des rushes ? Prolonger une vidéo poursuit un clip à partir de sa dernière image.
Conseils pour le prompt
- Nommez les images Image 1, Image 2 et Image 3, dans l’ordre où vous les envoyez.
- Choisissez des images nettes et bien éclairées, avec un seul sujet chacune.
- Dites ce que fait chaque sujet : les images donnent l’aspect, le prompt donne l’action.
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-fast/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 8,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# 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.