Luma Video Generation

Generate AI videos through AceDataCloud's Luma Dream Machine API.

Authentication

export ACEDATACLOUD_API_TOKEN="your-token-here"

Quick Start

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", "wait": true}'

Workflows

1. Text-to-Video

Generate video purely from a text description.

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.

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.

POST /luma/videos
{
  "action": "extend",
  "video_id": "existing-video-id",
  "prompt": "the camera continues forward through the forest"
}

Aspect Ratios

Parameters

Task Polling

POST /luma/tasks
{"task_id": "your-task-id"}

Poll every 5 seconds. States: pending → completed or failed.

MCP Server

pip install mcp-luma

Or hosted: https://luma.mcp.acedata.cloud/mcp

Key tools: luma_generate_video, luma_generate_video_from_image, luma_extend_video

Gotchas

• enhancement: true (default) improves prompt quality but may alter your intent — set to false for literal prompts
• Start/end image URLs must be publicly accessible
• loop: true creates seamless looping video — good for backgrounds and social media
• Extend requires the video_id from a previously completed generation
• Video generation takes 1–5 minutes depending on complexity
• Both start and end images are optional — you can use just one for partial guidance