luma-video — скилл для Claude Code: генерация видео
Скилл luma-video создаёт видео через Luma Dream Machine и AceDataCloud API: из текста, референсных изображений или готового ролика.
Apache-2.0 251 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill luma-video -a claude-codeЧто делает luma-video
luma-video отправляет запросы в AceDataCloud API для генерации видео из текстового описания, создания ролика по стартовому или финальному изображению и продолжения уже готового видео. Можно задать соотношение сторон, зациклить результат и управлять улучшением промпта.
Внутри используются маршруты /luma/videos и /luma/tasks: асинхронный запрос возвращает идентификатор задачи, после чего скилл проверяет её состояние. Для продолжения нужен video_id или video_url, а URL изображений должны быть общедоступными. Без ACEDATACLOUD_API_TOKEN в .env запросы к API не заработают.
Какие задачи решает
- создать видео по текстовому описанию
- анимировать сцену по стартовому изображению
- задать финальный кадр через референс
- продолжить ранее созданный ролик
- сделать зацикленное видео для фона
Примеры запросов агенту
- Создай видео по описанию: камера летит над горным озером на рассвете.
- Анимируй сцену из
scene.jpg, добавь лёгкое движение ветра и формат16:9. - Продолжи ролик с идентификатором
existing-video-id: камера движется вперёд через лес.
Как установить luma-video
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a claude-code2Вручную: положить файлы
~/.claude/skills/luma-video/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/luma-video/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a codex2Вручную: положить файлы
.agents/skills/luma-video/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a cursor2Вручную: положить файлы
.cursor/skills/luma-video/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/luma-video2Вручную: положить файлы
.github/skills/luma-video/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/luma-videoВручную: положить файлы
.devin/skills/luma-video/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill luma-video -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о luma-video
Как установить luma-video в Claude Code?
Выполните npx skills add AceDataCloud/Skills --skill luma-video -a claude-code. Файл скилла появится по пути ~/.claude/skills/luma-video/SKILL.md.
Что делает luma-video?
Скилл создаёт видео через Luma Dream Machine по тексту или изображениям, а также продолжает готовые ролики через AceDataCloud API.
Что нужно для работы с изображениями и продолжением видео?
Ссылки на стартовое и финальное изображения должны быть общедоступными. Для продолжения нужен video_id или video_url уже завершённой генерации.
Исходный текст
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