Introduction
Texte vers vidéo pour Veo 3.1 : un prompt en entrée, un clip de 4 à 8 secondes en 720p avec son généré en sortie.
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| 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. Dites qui ou quoi est dans le plan, ce qui se passe, comment bouge la caméra et à quoi cela ressemble au son ; dialogues entre guillemets. 1 caractères minimum · 4000 caractères maximum |
aspect_ratio | Non | 16:9 (par défaut, 1280x720) ou 9:16 (720x1280). Ne change pas le prix. |
duration_seconds | Non | Choisissez 4, 6 ou 8 secondes (8 par défaut). Le prix augmente avec la durée. |
Tarification
Facturé une fois par clip, au prix correspondant à sa durée de 4, 6 ou 8 secondes. Le format et le son 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 Texte vers vidéo est la voie à privilégier pour transformer une scène écrite en clip quand la qualité d’image prime : le palier supérieur de Veo chez Google produit 4, 6 ou 8 secondes en 720p, en 16:9 ou 9:16, et génère le son en même temps. Les prompts et les images passent par le contrôle propre à Google ; une requête qu’il refuse échoue et ne coûte rien.
Choisir un mode Veo 3.1
| Vous avez | Utilisez |
|---|---|
| seulement une scène écrite | Veo 3.1 Texte vers vidéo (vous êtes ici) |
| une image fixe pour ouvrir ou pour clore | Veo 3.1 Image vers vidéo |
| des images que vous voulez poursuivre | Veo 3.1 Prolonger une vidéo |
Conseils pour le prompt
- Construisez le prompt comme le plan : lieu et lumière, sujet, action, mouvement de caméra, puis le son.
- Mettez les dialogues entre guillemets et décrivez l’ambiance à part.
- Répétez en 4 secondes sur un palier moins cher, puis lancez le rendu final en 8.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"duration_seconds": 8
}
}'
# 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.