Génération de Vidéos Luma
Générez des vidéos IA via l'API Luma Dream Machine d'AceDataCloud.
Configuration : Voir authentification pour configurer le jeton.
Démarrage Rapide
curl -X POST https://api.acedata.cloud/luma/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "un drone survolant un lac de montagne au lever du soleil", "action": "generate", "callback_url": "https://api.acedata.cloud/health"}'
Asynchrone : Voir interrogation de tâches asynchrones. Interrogez via
POST /luma/tasksavec{"task_id": "..."}.
Flux de Travail
1. Texte-vers-Vidéo
Générez une vidéo uniquement à partir d'une description textuelle.
POST /luma/videos
{
"prompt": "un timelapse de fleurs s'épanouissant dans un jardin",
"action": "generate",
"aspect_ratio": "16:9",
"loop": false,
"enhancement": true
}
2. Image-vers-Vidéo
Utilisez des images de début et/ou de fin comme références pour guider la génération.
POST /luma/videos
{
"prompt": "la scène s'anime avec un vent doux",
"action": "generate",
"start_image_url": "https://example.com/scene.jpg",
"end_image_url": "https://example.com/scene-end.jpg",
"aspect_ratio": "16:9"
}
3. Étendre une Vidéo
Prolongez une vidéo existante avec une nouvelle consigne.
POST /luma/videos
{
"action": "extend",
"video_id": "existing-video-id",
"prompt": "la caméra continue d'avancer à travers la forêt"
}
Ratios d'Aspect
| Ratio | Cas d'Usage |
|---|---|
16:9 | Paysage (par défaut) — YouTube, TV |
9:16 | Portrait — TikTok, Stories Instagram |
1:1 | Carré — Réseaux sociaux |
4:3 | Classique — Présentations |
21:9 | Ultra-large — Cinématographique |
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
prompt | string | — | Description textuelle de la vidéo (obligatoire) |
action | string | "generate" | "generate" ou "extend" |
aspect_ratio | string | "16:9" | Ratio d'aspect de la vidéo |
loop | bool | false | Créer une boucle fluide |
enhancement | bool | true | Améliorer la consigne pour de meilleurs résultats |
start_image_url | string | — | URL de l'image de référence pour la première image |
end_image_url | string | — | URL de l'image de référence pour la dernière image |
video_id | string | — | ID de la vidéo à étendre (alternative à video_url) |
video_url | string | — | URL de la vidéo à étendre (alternative à video_id) |
timeout | number | — | Délai d'attente en secondes pour que l'API retourne les données |
callback_url | string | — | URL du webhook pour les notifications asynchrones |
Pièges à Éviter
enhancement: true(par défaut) améliore la qualité de la consigne mais peut altérer votre intention — définissez-le àfalsepour des consignes littérales- Les URLs des images de début/fin doivent être accessibles publiquement
loop: truecrée une vidéo en boucle fluide — idéal pour les arrière-plans et les réseaux sociaux- L'extension nécessite
video_idouvideo_urld'une génération précédemment terminée - La génération vidéo prend 1 à 5 minutes selon la complexité
- Les images de début et de fin sont optionnelles — vous pouvez n'en utiliser qu'une pour un guidage partiel
MCP :
pip install mcp-luma| Hébergé :https://luma.mcp.acedata.cloud/mcp| Voir tous les serveurs MCP