Agent skill
hailuo-video
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/hailuo-video-acedatacloud-skills
Metadata
Additional technical details for this skill
- author
- acedatacloud
- version
- 1.0
SKILL.md
Hailuo Video Generation
Generate AI videos through AceDataCloud's Hailuo (MiniMax) API.
Authentication
export ACEDATACLOUD_API_TOKEN="your-token-here"
Quick Start
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"}'
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
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.
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.
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) |
mirror |
No | boolean | Mirror the output |
callback_url |
No | string | Async callback URL |
Task Polling
POST /hailuo/tasks
{"task_id": "your-task-id"}
States: processing → succeed or failed.
Gotchas
first_image_urlis required forminimax-i2vandminimax-i2v-directormodels- Director mode (
minimax-i2v-director) provides finer camera/motion control than standard i2v - The
actionfield currently only supports"generate"— no extend or edit - Flat pricing per generation regardless of model
- Use
mirror: trueto horizontally flip the output if needed
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?