Génération de vidéos Veo
Générer des vidéos IA via l'API Google Veo d'AceDataCloud.
Configuration : Voir authentification pour la configuration du jeton.
Démarrage rapide
curl -X POST https://api.acedata.cloud/veo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "une baleine faisant irruption au ralenti à l\'heure dorée", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'
Asynchrone : Voir polling des tâches asynchrones. Interrogez via
POST /veo/tasksavec{"id": "..."}. Ceci renvoie immédiatement un ID de tâche. Interrogez pour obtenir le résultat :
curl -X POST https://api.acedata.cloud/veo/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id from above>"}'
Modèles
| Modèle | Audio | Idéal pour |
|---|---|---|
veo2 | Non | Génération économique |
veo2-fast | Non | Génération rapide et économique (par défaut) |
veo3 | Oui (natif) | Génération audiovisuelle complète |
veo3-fast | Oui (natif) | Génération audiovisuelle plus rapide |
veo31 | Oui (natif) | Veo 3.1, meilleure qualité |
veo31-fast | Oui (natif) | Variante rapide de Veo 3.1 |
veo31-fast-ingredients | Oui (natif) | Veo 3.1 rapide, mode ingrédients |
Workflows
1. Texte vers vidéo
POST /veo/videos
{
"action": "text2video",
"prompt": "plan aérien cinématographique des aurores boréales au-dessus de l'Islande",
"model": "veo3",
"resolution": "1080p"
}
2. Image vers vidéo
Animer des images fixes en vidéo.
POST /veo/videos
{
"action": "image2video",
"prompt": "la scène s'anime doucement avec du vent et un mouvement subtil",
"image_urls": ["https://example.com/landscape.jpg"],
"model": "veo2",
"aspect_ratio": "16:9"
}
3. Ingrédients vers vidéo (Fusion multi-images)
Fusionner 1 à 3 images de référence en une vidéo (uniquement veo31-fast-ingredients).
POST /veo/videos
{
"action": "ingredients2video",
"image_urls": [
"https://example.com/img1.jpg",
"https://example.com/img2.jpg"
],
"model": "veo31-fast-ingredients"
}
4. Mise à l'échelle en 1080p
Convertir une vidéo déjà générée en pleine résolution 1080p.
POST /veo/videos
{
"action": "get1080p",
"video_id": "votre-id-video",
"model": "veo3"
}
Paramètres
| Paramètre | Valeurs | Description |
|---|---|---|
action | "text2video", "image2video", "ingredients2video", "get1080p" | Mode de génération |
model | voir tableau Modèles | Modèle à utiliser (par défaut : veo2-fast) |
resolution | "4k", "1080p", "gif" | Résolution de sortie (par défaut : 720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | Ratio d'aspect — valide uniquement pour image2video |
image_urls | tableau de chaînes | URLs des images de référence — pour image2video (jusqu'à 2) ou ingredients2video (jusqu'à 3) |
video_id | chaîne | Vidéo à upscaler — uniquement pour get1080p |
translation | true / false | Traduire automatiquement le prompt en anglais (par défaut : false) |
Endpoints post-génération
Après avoir généré une vidéo, utilisez ces endpoints pour la traiter davantage :
Upsample (POST /veo/upsample)
Mettre à l'échelle une vidéo générée en 1080p, 4K, ou la convertir en GIF.
POST /veo/upsample
{
"video_id": "votre-id-video",
"action": "4k"
}
| Paramètre | Valeurs | Description |
|---|---|---|
video_id | chaîne | ID de tâche de /veo/videos, /veo/extend, /veo/reshoot ou /veo/objects |
action | "1080p", "4k", "gif" | Cible d'upsample |
Extend (POST /veo/extend)
Continuer une vidéo existante — l'IA génère automatiquement le segment suivant.
POST /veo/extend
{
"video_id": "votre-id-video",
"model": "veo31-fast",
"prompt": "la caméra effectue un zoom arrière lent"
}
| Paramètre | Valeurs | Description |
|---|---|---|
video_id | chaîne | ID de tâche de /veo/videos ou d'un précédent /veo/extend |
model | "veo31-fast", "veo31" | Seule la série Veo 3.1 est prise en charge |
prompt | chaîne | Optionnel : guide le segment étendu |
Reshoot (POST /veo/reshoot)
Restituer une vidéo en conservant le même contenu mais en appliquant un nouveau mouvement de caméra.
POST /veo/reshoot
{
"video_id": "votre-id-video",
"motion_type": "LEFT_TO_RIGHT"
}
| Paramètre | Valeurs | Description |
|---|---|---|
video_id | chaîne | ID de tâche de /veo/videos (ne peut pas utiliser la sortie de /veo/extend) |
motion_type | voir tableau ci-dessous | Mouvement de caméra à appliquer |
Valeurs de motion_type :
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
Objects (POST /veo/objects)
Insérer ou supprimer des objets dans une vidéo à l'aide d'un inpainting basé sur un masque.
POST /veo/objects
{
"video_id": "votre-id-video",
"action": "insert",
"prompt": "ajouter un oiseau en vol"
}
POST /veo/objects
{
"video_id": "votre-id-video",
"action": "remove",
"image_mask": "https://example.com/mask.jpg"
}
| Paramètre | Valeurs | Description |
|---|---|---|
video_id | chaîne | ID de tâche (ne peut pas utiliser la sortie de /veo/extend) |
action | "insert", "remove" | Type d'opération |
prompt | chaîne | Requis pour insert ; optionnel pour remove |
image_mask | chaîne | URL ou JPEG encodé en base64 — pixels blancs = zone cible. Requis pour remove ; optionnel pour insert |
Pièges à éviter
- Les modèles Veo 3 et 3.1 génèrent un audio natif —
veo2/veo2-fastne prennent PAS en charge l'audio - L'action
get1080putilisevideo_id(provenant d'une génération antérieure), pas une URL aspect_ratioest valide uniquement pour l'actionimage2videoimage_urlsaccepte un tableau — jusqu'à 2 images pourimage2video, jusqu'à 3 pouringredients2videoveo31-fast-ingredientsnécessite une entrée d'image — il ne peut pas faire de génération uniquement textuelletranslation: truetraduit automatiquement les prompts chinois ou autres langues non anglaises avant de les envoyer à Veo- Le polling des tâches utilise
id(et nontask_id) dans le corps de la requête/veo/tasks - Les états des tâches utilisent
"succeeded"(et non "completed") — vérifiez cette valeur lors du polling - La sortie de
/veo/extendne peut pas être utilisée comme entrée pour/veo/reshootou/veo/objects
MCP :
pip install mcp-veo| Hébergé :https://veo.mcp.acedata.cloud/mcp| Voir tous les serveurs MCP