Agent Skills
› NeverSight/learn-skills.dev
› luma-video
luma-video
GitHub通过AceDataCloud API调用Luma Dream Machine生成AI视频。支持文本转视频、图像转视频及视频扩展，可自定义比例与循环效果。
Trigger Scenarios
需要生成AI视频
根据文本描述创建视频
基于参考图片生成视频
延长现有视频时长
Install
npx skills add NeverSight/learn-skills.dev --skill luma-video -g -y
SKILL.md
Frontmatter
{
"name": "luma-video",
"license": "Apache-2.0",
"metadata": {
"author": "acedatacloud",
"version": "1.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."
}
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/taskswith{"task_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 tofalsefor literal prompts- Start/end image URLs must be publicly accessible
loop: truecreates seamless looping video — good for backgrounds and social media- Extend requires either
video_idorvideo_urlfrom 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
Version History
- e0220ca Current 2026-07-05 22:54
