hailuo-video — скилл для Claude Code: генерация AI-видео
Скилл hailuo-video генерирует видео из текста или анимирует картинки через API Hailuo (MiniMax) от AceDataCloud. Работает через три модели: текст-в-видео, картинка-в-видео и режим режиссёра для точного контроля над камерой.
Apache-2.0 235 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill hailuo-video -a claude-codeЧто делает hailuo-video
Скилл вызывает Hailuo — генератор видео от MiniMax — через платформу AceDataCloud. Поддерживает три модели: minimax-t2v собирает ролик из текстового описания, minimax-i2v анимирует статичное изображение, minimax-i2v-director даёт тонкую настройку движения камеры и объектов в кадре. Запросы асинхронные: сервер возвращает ID задачи, которую нужно опрашивать через /hailuo/tasks до завершения.
Для работы нужен ключ AceDataCloud в переменной ACEDATACLOUD_API_TOKEN в ~/.openclaw/.env. Ключ берётся в разделе Applications на platform.acedata.cloud; нужен именно API-ключ сервиса (начинается с platform-...), не токен управления. Если включены ограничения Allowed APIs, добавьте /hailuo/videos и /hailuo/tasks.
Для моделей minimax-i2v и minimax-i2v-director обязателен параметр first_image_url с адресом исходного изображения. Тариф одинаковый для всех моделей, различается только качество контроля.
Какие задачи решает
- сгенерировать видео из текстового описания сцены
- анимировать статичную картинку в короткий ролик
- настроить движение камеры и объектов в кадре через режим режиссёра
- опрашивать статус задачи генерации видео через
/hailuo/tasks
Примеры запросов агенту
- Сгенерируй видео: дельфин выпрыгивает из воды на закате, используй
minimax-t2v - Анимируй картинку
scene.jpg: лёгкий ветер, листья падают, модельminimax-i2v-director - Проверь статус задачи Hailuo с ID
abc123через/hailuo/tasks
Как установить hailuo-video
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill hailuo-video -a claude-code2Вручную: положить файлы
~/.claude/skills/hailuo-video/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hailuo-video/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill hailuo-video -a codex2Вручную: положить файлы
.agents/skills/hailuo-video/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill hailuo-video -a cursor2Вручную: положить файлы
.cursor/skills/hailuo-video/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/hailuo-video2Вручную: положить файлы
.github/skills/hailuo-video/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill hailuo-video -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/hailuo-videoВручную: положить файлы
.devin/skills/hailuo-video/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill hailuo-video -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hailuo-video
Как установить hailuo-video в Claude Code?
Выполните npx skills add AceDataCloud/Skills --skill hailuo-video -a claude-code, затем откройте ~/.claude/skills/hailuo-video/SKILL.md.
Что делает hailuo-video?
Генерирует видео из текста или анимирует изображения через API Hailuo (MiniMax) от AceDataCloud. Поддерживает три модели: текст-в-видео, картинка-в-видео и режим режиссёра.
Чем режим режиссёра отличается от обычной анимации картинки?
Модель minimax-i2v-director даёт более тонкий контроль над движением камеры и объектов в кадре, чем стандартная minimax-i2v.
Исходный текст
SKILL.md · Apache-2.0
---
name: hailuo-video
description: Generate AI videos with Hailuo (MiniMax) via AceDataCloud API. Use when creating videos from text descriptions or animating images into video. Supports text-to-video and image-to-video with director mode for precise control.
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).
---
# Hailuo Video Generation
Generate AI videos through AceDataCloud's Hailuo (MiniMax) API.
## First-time setup
1. Install the official Skill with `clawhub install @acedatacloud/hailuo`. Check that the ClawHub publisher is **@acedatacloud**.
2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Hailuo 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 `/hailuo/videos` and `/hailuo/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/hailuo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "generate", "prompt": "a dolphin jumping through ocean waves at golden hour", "model": "minimax-t2v"}'
```
> **Async:** See [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md). Poll via `POST /hailuo/tasks` with `{"id": "..."}`.
## Models
| Model | Type | Best For |
|-------|------|----------|
| `minimax-t2v` | Text-to-Video | Creating video from text description |
| `minimax-i2v` | Image-to-Video | Animating a still image |
| `minimax-i2v-director` | Image-to-Video (Director) | Precise control over animation from image |
## Workflows
### 1. Text-to-Video
```json
POST /hailuo/videos
{
"action": "generate",
"prompt": "a time-lapse of flowers blooming in a meadow",
"model": "minimax-t2v"
}
```
### 2. Image-to-Video
Animate a still image into a video clip.
```json
POST /hailuo/videos
{
"action": "generate",
"prompt": "gentle wind blows through the scene",
"model": "minimax-i2v",
"first_image_url": "https://example.com/landscape.jpg"
}
```
### 3. Image-to-Video (Director Mode)
More precise control over the animation.
```json
POST /hailuo/videos
{
"action": "generate",
"prompt": "camera slowly zooms in while leaves fall gently",
"model": "minimax-i2v-director",
"first_image_url": "https://example.com/scene.jpg"
}
```
## Parameters
| Parameter | Required | Values | Description |
|-----------|----------|--------|-------------|
| `action` | Yes | `"generate"` | Action type |
| `prompt` | Yes | string | Video description |
| `model` | Yes | `"minimax-t2v"`, `"minimax-i2v"`, `"minimax-i2v-director"` | Model |
| `first_image_url` | For i2v | string | Source image URL (required for image-to-video) |
| `callback_url` | No | string | Async callback URL |
## Gotchas
- `first_image_url` is **required** for `minimax-i2v` and `minimax-i2v-director` models
- Director mode (`minimax-i2v-director`) provides finer camera/motion control than standard i2v
- The `action` field currently only supports `"generate"` — no extend or edit
- Flat pricing per generation regardless of model
© acedatacloud · Apache-2.0 · AceDataCloud/Skills