Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill luma-video -a claude-code
Open on GitHub

What 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.jpg with a gentle breeze and use the 16:9 aspect ratio.
  • Continue the video with ID existing-video-id as the camera moves through the forest.

How to install luma-video

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill luma-video -a claude-code

2Manually: put the files in place

~/.claude/skills/luma-video/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/luma-video/

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

Similar skills

All skills for AI and ML →

From the same set67

The whole set →
fish-audio Turns text into speech through the AceDataCloud Fish Audio API. It also finds saved voices, builds a permanent public voice model, or makes a one-shot clone from an HTTPS audio link plus exact transcript. CX Codex +1 4,200installs suno-music The suno-music Claude Code skill creates songs, instrumental music, and lyrics through Suno. It activates for requests to generate music or a song. CX Codex +1 287installs microsoft-outlook The microsoft-outlook skill handles Outlook mail and calendar events through Microsoft Graph. Use it to search messages, prepare mail, and manage meetings. CX Codex +1 269installs wechat-official-account Manages WeChat Official Account drafts, images, customer messages, and stats via the WeChat MP server-side API using curl and jq. CX Codex +1 255installs seedance-video seedance-video generates video from text or images through AceDataCloud's Seedance API, and lets the agent poll the task, edit or extend a clip. CX Codex +1 241installs veo-video veo-video — a skill for Claude Code, Codex, Cursor and other platforms that generates videos via Google Veo API. Triggered by a prompt, animates still images, blends references, and upscales to 1080p. CX Codex +1 241installs kling-video kling-video generates AI video via the AceDataCloud Kuaishou Kling API. Use it to render text prompts, animate still frames, extend existing clips, and run lip sync. CX Codex +1 240installs flux-image flux-image is a Claude Code skill for generating and editing images through the AceDataCloud Flux API, including text-to-image, instruction-based edits, and FLUX 3 video. CX Codex +1 238installs

Project sponsors

Companies that keep this analytics open