hailuo-videolisted
Install: claude install-skill AceDataCloud/Skills
# Hailuo Video Generation
Generate AI videos through AceDataCloud's Hailuo (MiniMax) API.
> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
## 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](../_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 zoom