Luma Video Generation

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

Setup: See authentication for token setup.

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", "callback_url": "https://api.acedata.cloud/health"}'

Async: See async task polling. Poll via POST /luma/tasks with {"id": "..."}.

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

Ratio	Use Case
`16:9`	Landscape (default) — YouTube, TV
`9:16`	Portrait — TikTok, Instagram Stories
`1:1`	Square — Social media
`4:3`	Classic — Presentations
`21:9`	Ultra-wide — Cinematic

Parameters

Parameter	Type	Default	Description
`prompt`	string	—	Text description of the video (required)
`action`	string	`"generate"`	`"generate"` or `"extend"`
`aspect_ratio`	string	`"16:9"`	Video aspect ratio
`loop`	bool	`false`	Create seamless loop
`enhancement`	bool	`true`	Enhance prompt for better results
`start_image_url`	string	—	Reference image for first frame
`end_image_url`	string	—	Reference image for last frame
`video_id`	string	—	ID of video to extend (alternative to `video_url`)
`video_url`	string	—	URL of video to extend (alternative to `video_id`)
`timeout`	number	—	Timeout in seconds for the API to return data
`callback_url`	string	—	Webhook URL for async notifications

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 either video_id or video_url 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

MCP: pip install mcp-luma | Hosted: https://luma.mcp.acedata.cloud/mcp | See all MCP servers

luma-video