Generación de Video con Luma
Genera videos con IA a través de la API Luma Dream Machine de AceDataCloud.
Configuración: Consulta autenticación para configurar el token.
Inicio Rápido
curl -X POST https://api.acedata.cloud/luma/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "un dron volando sobre un lago de montaña al amanecer", "action": "generate", "callback_url": "https://api.acedata.cloud/health"}'
Asíncrono: Consulta sondeo de tareas asíncronas. Sondea mediante
POST /luma/taskscon{"task_id": "..."}.
Flujos de Trabajo
1. Texto a Video
Genera un video puramente a partir de una descripción de texto.
POST /luma/videos
{
"prompt": "una secuencia time-lapse de flores floreciendo en un jardín",
"action": "generate",
"aspect_ratio": "16:9",
"loop": false,
"enhancement": true
}
2. Imagen a Video
Usa imágenes de referencia de inicio y/o fin para guiar la generación.
POST /luma/videos
{
"prompt": "la escena cobra vida con una brisa suave",
"action": "generate",
"start_image_url": "https://ejemplo.com/escena.jpg",
"end_image_url": "https://ejemplo.com/escena-fin.jpg",
"aspect_ratio": "16:9"
}
3. Extender un Video
Continúa un video existente con un nuevo prompt.
POST /luma/videos
{
"action": "extend",
"video_id": "id-del-video-existente",
"prompt": "la cámara continúa avanzando a través del bosque"
}
Relaciones de Aspecto
| Relación | Caso de Uso |
|---|---|
16:9 | Paisaje (predeterminada) — YouTube, TV |
9:16 | Retrato — TikTok, Instagram Stories |
1:1 | Cuadrada — Redes sociales |
4:3 | Clásica — Presentaciones |
21:9 | Ultra-panorámica — Cinematográfica |
Parámetros
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
prompt | string | — | Descripción textual del video (requerido) |
action | string | "generate" | "generate" o "extend" |
aspect_ratio | string | "16:9" | Relación de aspecto del video |
loop | bool | false | Crear bucle sin costura |
enhancement | bool | true | Mejorar el prompt para mejores resultados |
start_image_url | string | — | URL de imagen de referencia para el primer fotograma |
end_image_url | string | — | URL de imagen de referencia para el último fotograma |
video_id | string | — | ID del video a extender (alternativa a video_url) |
video_url | string | — | URL del video a extender (alternativa a video_id) |
timeout | number | — | Tiempo de espera en segundos para que la API devuelva datos |
callback_url | string | — | URL del webhook para notificaciones asíncronas |
Advertencias
enhancement: true(predeterminado) mejora la calidad del prompt pero puede alterar tu intención — establece enfalsepara prompts literales- Las URLs de imágenes de inicio/fin deben ser accesibles públicamente
loop: truecrea un video de bucle sin costura — ideal para fondos y redes sociales- La extensión requiere
video_idovideo_urlde una generación previamente completada - La generación de video toma de 1 a 5 minutos según la complejidad
- Tanto la imagen de inicio como la de fin son opcionales — puedes usar solo una para guía parcial
MCP:
pip install mcp-luma| Alojado:https://luma.mcp.acedata.cloud/mcp| Consulta todos los servidores MCP