luma-videolisted

# Luma Video Generation Generate AI videos through AceDataCloud's Luma Dream Machine API. > **Setup:** See [authentication](../_shared/authentication.md) for token setup. ## Quick Start ```bash curl -X POST https://api.acedata.cloud/luma/videos \ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"prompt": "a drone flying over a mountain lake at sunrise", "action": "generate", "callback_url": "https://api.acedata.cloud/health"}' ``` > **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /luma/tasks` with `{"id": "..."}`. ## Workflows ### 1. Text-to-Video Generate video purely from a text description. ```json POST /luma/videos { "prompt": "a timelapse of flowers blooming in a garden", "action": "generate", "aspect_ratio": "16:9", "loop": false, "enhancement": true } ``` ### 2. Image-to-Video Use start and/or end reference images to guide generation. ```json POST /luma/videos { "prompt": "the scene comes alive with gentle wind", "action": "generate", "start_image_url": "https://example.com/scene.jpg", "end_image_url": "https://example.com/scene-end.jpg", "aspect_ratio": "16:9" } ``` ### 3. Extend a Video Continue an existing video with a new prompt. ```json POST /luma/videos { "action": "extend", "video_id": "existing-video-id", "prompt": "the camera continues forward through the forest" } ``` ## Aspect Ratios | Ratio | Use Case | |-------|----------| | `16:9`