{"id":"73684f90-10c1-4d4a-953e-1665ecb70149","shortId":"P7NRUc","kind":"skill","title":"luma-video","tagline":"Generate AI videos with Luma Dream Machine via AceDataCloud API. Use when creating videos from text prompts, generating videos from reference images, extending existing videos, or any video generation task with Luma. Supports text-to-video, image-to-video, and video extension.","description":"# Luma Video Generation\n\nGenerate AI videos through AceDataCloud's Luma Dream Machine API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/luma/videos \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\": \"a drone flying over a mountain lake at sunrise\", \"action\": \"generate\", \"callback_url\": \"https://api.acedata.cloud/health\"}'\n```\n\n> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /luma/tasks` with `{\"task_id\": \"...\"}`.\n\n## Workflows\n\n### 1. Text-to-Video\n\nGenerate video purely from a text description.\n\n```json\nPOST /luma/videos\n{\n  \"prompt\": \"a timelapse of flowers blooming in a garden\",\n  \"action\": \"generate\",\n  \"aspect_ratio\": \"16:9\",\n  \"loop\": false,\n  \"enhancement\": true\n}\n```\n\n### 2. Image-to-Video\n\nUse start and/or end reference images to guide generation.\n\n```json\nPOST /luma/videos\n{\n  \"prompt\": \"the scene comes alive with gentle wind\",\n  \"action\": \"generate\",\n  \"start_image_url\": \"https://example.com/scene.jpg\",\n  \"end_image_url\": \"https://example.com/scene-end.jpg\",\n  \"aspect_ratio\": \"16:9\"\n}\n```\n\n### 3. Extend a Video\n\nContinue an existing video with a new prompt.\n\n```json\nPOST /luma/videos\n{\n  \"action\": \"extend\",\n  \"video_id\": \"existing-video-id\",\n  \"prompt\": \"the camera continues forward through the forest\"\n}\n```\n\n## Aspect Ratios\n\n| Ratio | Use Case |\n|-------|----------|\n| `16:9` | Landscape (default) — YouTube, TV |\n| `9:16` | Portrait — TikTok, Instagram Stories |\n| `1:1` | Square — Social media |\n| `4:3` | Classic — Presentations |\n| `21:9` | Ultra-wide — Cinematic |\n\n## Parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `prompt` | string | — | Text description of the video (required) |\n| `action` | string | `\"generate\"` | `\"generate\"` or `\"extend\"` |\n| `aspect_ratio` | string | `\"16:9\"` | Video aspect ratio |\n| `loop` | bool | `false` | Create seamless loop |\n| `enhancement` | bool | `true` | Enhance prompt for better results |\n| `start_image_url` | string | — | Reference image for first frame |\n| `end_image_url` | string | — | Reference image for last frame |\n| `video_id` | string | — | ID of video to extend (alternative to `video_url`) |\n| `video_url` | string | — | URL of video to extend (alternative to `video_id`) |\n| `timeout` | number | — | Timeout in seconds for the API to return data |\n| `callback_url` | string | — | Webhook URL for async notifications |\n\n## Gotchas\n\n- `enhancement: true` (default) improves prompt quality but may alter your intent — set to `false` for literal prompts\n- Start/end image URLs must be publicly accessible\n- `loop: true` creates seamless looping video — good for backgrounds and social media\n- Extend requires either `video_id` or `video_url` from a previously completed generation\n- Video generation takes 1–5 minutes depending on complexity\n- Both start and end images are optional — you can use just one for partial guidance\n\n> **MCP:** `pip install mcp-luma` | Hosted: `https://luma.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)","tags":["luma","video","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-luma-video","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/luma-video","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (3,202 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:02.891Z","embedding":null,"createdAt":"2026-05-18T13:21:33.387Z","updatedAt":"2026-05-18T19:14:02.891Z","lastSeenAt":"2026-05-18T19:14:02.891Z","tsv":"'/_shared/async-tasks.md':111 '/_shared/authentication.md':64 '/_shared/mcp-servers.md':450 '/health':105 '/luma/tasks':115 '/luma/videos':76,134,170,211 '/mcp':445 '/scene-end.jpg':192 '/scene.jpg':186 '1':120,245,246,415 '16':148,195,233,240,282 '2':154 '21':254 '3':197,251 '4':250 '5':416 '9':149,196,234,239,255,283 'access':386 'acedatacloud':12,55,80 'action':99,144,179,212,273 'ai':5,52 'aliv':175 'alter':371 'altern':327,339 'and/or':161 'api':13,60,81,350 'api.acedata.cloud':75,104 'api.acedata.cloud/health':103 'api.acedata.cloud/luma/videos':74 'application/json':87 'aspect':146,193,228,279,285 'async':106,108,360 'authent':63 'author':78 'background':395 'bash':70 'bearer':79 'better':299 'bloom':140 'bool':288,294 'callback':101,354 'camera':222 'case':232 'cinemat':259 'classic':252 'come':174 'complet':410 'complex':420 'content':85 'content-typ':84 'continu':201,223 'creat':16,290,389 'curl':71 'd':88 'data':353 'default':236,263,365 'depend':418 'descript':131,264,268 'dream':9,58 'drone':91 'either':401 'end':162,187,310,424 'enhanc':152,293,296,363 'example.com':185,191 'example.com/scene-end.jpg':190 'example.com/scene.jpg':184 'exist':27,203,217 'existing-video-id':216 'extend':26,198,213,278,326,338,399 'extens':47 'fals':151,289,376 'first':308 'fli':92 'flower':139 'forest':227 'forward':224 'frame':309,318 'garden':143 'generat':4,21,32,50,51,100,125,145,167,180,275,276,411,413 'gentl':177 'good':393 'gotcha':362 'guid':166 'guidanc':435 'h':77,83 'host':442 'id':118,215,219,320,322,342,403 'imag':25,42,156,164,182,188,302,306,311,315,381,425 'image-to-video':41,155 'improv':366 'instagram':243 'instal':438 'intent':373 'json':132,168,209 'lake':96 'landscap':235 'last':317 'liter':378 'loop':150,287,292,387,391 'luma':2,8,35,48,57,441 'luma-video':1 'luma.mcp.acedata.cloud':444 'luma.mcp.acedata.cloud/mcp':443 'machin':10,59 'may':370 'mcp':436,440,448 'mcp-luma':439 'media':249,398 'minut':417 'mountain':95 'must':383 'new':207 'notif':361 'number':344 'one':432 'option':427 'paramet':260,261 'partial':434 'pip':437 'poll':110,112 'portrait':241 'post':73,114,133,169,210 'present':253 'previous':409 'prompt':20,89,135,171,208,220,265,297,367,379 'public':385 'pure':127 'qualiti':368 'quick':68 'ratio':147,194,229,230,280,286 'refer':24,163,305,314 'requir':272,400 'result':300 'return':352 'scene':173 'seamless':291,390 'second':347 'see':62,107,446 'server':449 'set':374 'setup':61,67 'skill' 'skill-luma-video' 'social':248,397 'source-acedatacloud' 'squar':247 'start':69,160,181,301,422 'start/end':380 'stori':244 'string':266,274,281,304,313,321,333,356 'sunris':98 'support':36 'take':414 'task':33,109,117 'text':19,38,122,130,267 'text-to-video':37,121 'tiktok':242 'timelaps':137 'timeout':343,345 'token':66,82 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'true':153,295,364,388 'tv':238 'type':86,262 'ultra':257 'ultra-wid':256 'url':102,183,189,303,312,330,332,334,355,358,382,406 'use':14,159,231,430 'via':11,113 'video':3,6,17,22,28,31,40,44,46,49,53,124,126,158,200,204,214,218,271,284,319,324,329,331,336,341,392,402,405,412 'webhook':357 'wide':258 'wind':178 'workflow':119 'x':72 'youtub':237","prices":[{"id":"251ecae6-e358-45f6-85ef-61116dbf8362","listingId":"73684f90-10c1-4d4a-953e-1665ecb70149","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:33.387Z"}],"sources":[{"listingId":"73684f90-10c1-4d4a-953e-1665ecb70149","source":"github","sourceId":"AceDataCloud/Skills/luma-video","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/luma-video","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:33.387Z","lastSeenAt":"2026-05-18T19:14:02.891Z"}],"details":{"listingId":"73684f90-10c1-4d4a-953e-1665ecb70149","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"luma-video","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"f87777897d9fda9d03828d8693a69bd59b9b2704","skill_md_path":"skills/luma-video/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/luma-video"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"luma-video","license":"Apache-2.0","description":"Generate AI videos with Luma Dream Machine via AceDataCloud API. Use when creating videos from text prompts, generating videos from reference images, extending existing videos, or any video generation task with Luma. Supports text-to-video, image-to-video, and video extension.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-luma for tool-use."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/luma-video"},"updatedAt":"2026-05-18T19:14:02.891Z"}}