luma-video — Claude Code skill: video generation
luma-video is a Claude Code skill that generates videos through Luma Dream Machine and the AceDataCloud API from text, reference images, or existing videos.
Apache-2.0 251 installs ★ 17 updated 2026-10-25
npx skills add AceDataCloud/Skills --skill luma-video -a claude-codeWhat luma-video does
luma-video sends requests to the AceDataCloud API for text-to-video generation, image-guided clips, and extensions of completed videos. You can set an aspect ratio, create a loop, and choose whether the prompt should be enhanced.
The skill works with /luma/videos and /luma/tasks. An asynchronous request returns a task ID, which is then checked until completion. Video extension needs a video_id or video_url, while image URLs must be publicly reachable. Requests will fail without ACEDATACLOUD_API_TOKEN in .env.
What it helps with
- generate a clip from a text prompt
- animate a scene from a reference image
- set a final frame with an image URL
- continue a previously generated video
- create a looping background clip
Example prompts for the agent
- Create a video of a camera flying over a mountain lake at sunrise.
- Animate
scene.jpgwith a gentle breeze and use the16:9aspect ratio. - Continue the video with ID
existing-video-idas the camera moves through the forest.
How to install luma-video
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a claude-code2Manually: put the files in place
~/.claude/skills/luma-video/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/luma-video/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a codex2Manually: put the files in place
.agents/skills/luma-video/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a cursor2Manually: put the files in place
.cursor/skills/luma-video/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/luma-video2Manually: put the files in place
.github/skills/luma-video/SKILL.md1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a gemini-cli2Platform CLI
gemini skills install https://github.com/AceDataCloud/Skills --path skills/luma-videoManually: put the files in place
.devin/skills/luma-video/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about luma-video
How do I install luma-video in Claude Code?
Run npx skills add AceDataCloud/Skills --skill luma-video -a claude-code. The skill file will be placed at ~/.claude/skills/luma-video/SKILL.md.
What does luma-video do?
It generates videos through Luma Dream Machine via AceDataCloud API, using text prompts or reference images, and can extend completed videos.
What does video extension require?
Provide either a video_id or a video_url from a completed generation. Reference image URLs used for guided generation must be publicly accessible.
Source text
SKILL.md · Apache-2.0
---
name: luma-video
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.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (get an API key at https://platform.acedata.cloud/console/applications). Optionally pair with mcp-luma for tool-use.
---
# Luma Video Generation
Generate AI videos through AceDataCloud's Luma Dream Machine API.
## First-time setup
1. Install the official Skill with `clawhub install @acedatacloud/luma`. Check that the ClawHub publisher is **@acedatacloud**.
2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Luma access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
3. If you enable **Allowed APIs** restrictions, include `/luma/videos` and `/luma/tasks`. Advanced workflows below may call additional routes.
4. On the OpenClaw Gateway host, put `ACEDATACLOUD_API_TOKEN=your_api_key_here` in `~/.openclaw/.env`, then restart the Gateway and start a new session. For a direct terminal test, run `export ACEDATACLOUD_API_TOKEN="your_api_key_here"` in that shell. Never put the key in a prompt or commit an `.env` file.
5. Run the **Quick Start** below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.
[Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)
## 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", "async": true}'
```
> **Async:** See [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_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` | 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](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/mcp-servers.md)
© acedatacloud · Apache-2.0 · AceDataCloud/Skills