{"id":"80b8082e-f050-4645-b054-33d533b724f9","shortId":"yDpywt","kind":"skill","title":"hailuo-video","tagline":"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.","description":"# Hailuo Video Generation\n\nGenerate AI videos through AceDataCloud's Hailuo (MiniMax) API.\n\n> **Setup:** See [authentication](../_shared/authentication.md) for token setup.\n\n## Quick Start\n\n```bash\ncurl -X POST https://api.acedata.cloud/hailuo/videos \\\n  -H \"Authorization: Bearer $ACEDATACLOUD_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"action\": \"generate\", \"prompt\": \"a dolphin jumping through ocean waves at golden hour\", \"model\": \"minimax-t2v\"}'\n```\n\n> **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /hailuo/tasks` with `{\"task_id\": \"...\"}`.\n## Models\n\n| Model | Type | Best For |\n|-------|------|----------|\n| `minimax-t2v` | Text-to-Video | Creating video from text description |\n| `minimax-i2v` | Image-to-Video | Animating a still image |\n| `minimax-i2v-director` | Image-to-Video (Director) | Precise control over animation from image |\n\n## Workflows\n\n### 1. Text-to-Video\n\n```json\nPOST /hailuo/videos\n{\n  \"action\": \"generate\",\n  \"prompt\": \"a time-lapse of flowers blooming in a meadow\",\n  \"model\": \"minimax-t2v\"\n}\n```\n\n### 2. Image-to-Video\n\nAnimate a still image into a video clip.\n\n```json\nPOST /hailuo/videos\n{\n  \"action\": \"generate\",\n  \"prompt\": \"gentle wind blows through the scene\",\n  \"model\": \"minimax-i2v\",\n  \"first_image_url\": \"https://example.com/landscape.jpg\"\n}\n```\n\n### 3. Image-to-Video (Director Mode)\n\nMore precise control over the animation.\n\n```json\nPOST /hailuo/videos\n{\n  \"action\": \"generate\",\n  \"prompt\": \"camera slowly zooms in while leaves fall gently\",\n  \"model\": \"minimax-i2v-director\",\n  \"first_image_url\": \"https://example.com/scene.jpg\"\n}\n```\n\n## Parameters\n\n| Parameter | Required | Values | Description |\n|-----------|----------|--------|-------------|\n| `action` | Yes | `\"generate\"` | Action type |\n| `prompt` | Yes | string | Video description |\n| `model` | Yes | `\"minimax-t2v\"`, `\"minimax-i2v\"`, `\"minimax-i2v-director\"` | Model |\n| `first_image_url` | For i2v | string | Source image URL (required for image-to-video) |\n| `callback_url` | No | string | Async callback URL |\n\n## Gotchas\n\n- `first_image_url` is **required** for `minimax-i2v` and `minimax-i2v-director` models\n- Director mode (`minimax-i2v-director`) provides finer camera/motion control than standard i2v\n- The `action` field currently only supports `\"generate\"` — no extend or edit\n- Flat pricing per generation regardless of model","tags":["hailuo","video","skills","acedatacloud","acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code"],"capabilities":["skill","source-acedatacloud","skill-hailuo-video","topic-acedata-cloud","topic-agent-skills","topic-agentskills","topic-ai-image","topic-ai-music","topic-ai-tools","topic-ai-video","topic-claude-code","topic-cursor","topic-gemini-cli","topic-github-copilot","topic-mcp"],"categories":["Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AceDataCloud/Skills/hailuo-video","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AceDataCloud/Skills","source_repo":"https://github.com/AceDataCloud/Skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (2,394 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:02.695Z","embedding":null,"createdAt":"2026-05-18T13:21:33.128Z","updatedAt":"2026-05-18T19:14:02.695Z","lastSeenAt":"2026-05-18T19:14:02.695Z","tsv":"'/_shared/async-tasks.md':102 '/_shared/authentication.md':56 '/hailuo/tasks':106 '/hailuo/videos':68,161,194,229 '/landscape.jpg':213 '/scene.jpg':251 '1':154 '2':179 '3':214 'acedatacloud':11,48,72 'action':81,162,195,230,257,260,332 'ai':5,45 'anim':21,134,150,184,226 'api':12,52,73 'api.acedata.cloud':67 'api.acedata.cloud/hailuo/videos':66 'application/json':79 'async':97,99,299 'authent':55 'author':70 'bash':62 'bearer':71 'best':113 'bloom':171 'blow':200 'callback':295,300 'camera':233 'camera/motion':326 'clip':191 'content':77 'content-typ':76 'control':40,148,223,327 'creat':15,122 'curl':63 'current':334 'd':80 'descript':19,126,256,266 'director':36,141,146,219,245,278,316,318,323 'dolphin':85 'edit':341 'example.com':212,250 'example.com/landscape.jpg':211 'example.com/scene.jpg':249 'extend':339 'fall':239 'field':333 'finer':325 'first':208,246,280,303 'flat':342 'flower':170 'generat':4,43,44,82,163,196,231,259,337,345 'gentl':198,240 'golden':91 'gotcha':302 'h':69,75 'hailuo':2,8,41,50 'hailuo-video':1 'hour':92 'i2v':129,140,207,244,274,277,284,311,315,322,330 'id':109 'imag':22,32,131,137,143,152,181,187,209,216,247,281,287,292,304 'image-to-video':31,130,142,180,215,291 'json':159,192,227 'jump':86 'laps':168 'leav':238 'meadow':174 'minimax':9,51,95,116,128,139,177,206,243,270,273,276,310,314,321 'minimax-i2v':127,205,272,309 'minimax-i2v-director':138,242,275,313,320 'minimax-t2v':94,115,176,269 'mode':37,220,319 'model':93,110,111,175,204,241,267,279,317,348 'ocean':88 'paramet':252,253 'per':344 'poll':101,103 'post':65,105,160,193,228 'precis':39,147,222 'price':343 'prompt':83,164,197,232,262 'provid':324 'quick':60 'regardless':346 'requir':254,289,307 'scene':203 'see':54,98 'setup':53,59 'skill' 'skill-hailuo-video' 'slowli':234 'sourc':286 'source-acedatacloud' 'standard':329 'start':61 'still':136,186 'string':264,285,298 'support':25,336 't2v':96,117,178,271 'task':100,108 'text':18,27,119,125,156 'text-to-video':26,118,155 'time':167 'time-laps':166 'token':58,74 'topic-acedata-cloud' 'topic-agent-skills' 'topic-agentskills' 'topic-ai-image' 'topic-ai-music' 'topic-ai-tools' 'topic-ai-video' 'topic-claude-code' 'topic-cursor' 'topic-gemini-cli' 'topic-github-copilot' 'topic-mcp' 'type':78,112,261 'url':210,248,282,288,296,301,305 'use':13 'valu':255 'via':10,104 'video':3,6,16,24,29,34,42,46,121,123,133,145,158,183,190,218,265,294 'wave':89 'wind':199 'workflow':153 'x':64 'yes':258,263,268 'zoom':235","prices":[{"id":"63f53ef6-f635-4e5d-a4b7-87950a23b74b","listingId":"80b8082e-f050-4645-b054-33d533b724f9","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AceDataCloud","category":"Skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:33.128Z"}],"sources":[{"listingId":"80b8082e-f050-4645-b054-33d533b724f9","source":"github","sourceId":"AceDataCloud/Skills/hailuo-video","sourceUrl":"https://github.com/AceDataCloud/Skills/tree/main/skills/hailuo-video","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:33.128Z","lastSeenAt":"2026-05-18T19:14:02.695Z"}],"details":{"listingId":"80b8082e-f050-4645-b054-33d533b724f9","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AceDataCloud","slug":"hailuo-video","github":{"repo":"AceDataCloud/Skills","stars":7,"topics":["acedata-cloud","agent-skills","agentskills","ai-image","ai-music","ai-tools","ai-video","claude-code","cursor","gemini-cli","github-copilot","mcp","npm","openai-codex","roo-code"],"license":"other","html_url":"https://github.com/AceDataCloud/Skills","pushed_at":"2026-05-18T07:35:03Z","description":"Agent Skills for AceDataCloud AI services — music, image, video generation, web search, and more. Compatible with Claude Code, GitHub Copilot, Gemini CLI, and all agentskills.io-compatible agents.","skill_md_sha":"ee6764b6ecdf2059834df2ddc64cac833a6ad60e","skill_md_path":"skills/hailuo-video/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AceDataCloud/Skills/tree/main/skills/hailuo-video"},"layout":"multi","source":"github","category":"Skills","frontmatter":{"name":"hailuo-video","license":"Apache-2.0","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.","compatibility":"Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md)."},"skills_sh_url":"https://skills.sh/AceDataCloud/Skills/hailuo-video"},"updatedAt":"2026-05-18T19:14:02.695Z"}}