MCP Server Guide

Use Hailuo 2.3 Pro from Claude Code

Hailuo 2.3 Pro is MiniMax's flagship video generation model, exceptional at realistic human motion and faces. Pair with a source image of a person and animate them naturally. Best in class for character-based animation.

If you use Claude Code and you want Hailuo 2.3 Pro available as a native tool that the agent can call directly, the AetherWave MCP server wires it up in one command. No SDK to learn, no separate API key per provider, no polling loop to write.

Install in 30 seconds

Run this from your terminal:

claude mcp add aetherwave \
-e AETHERWAVE_API_KEY=aw_live_your_key_here \
-- npx -y @aetherwave-studio/mcp

Get your API key at your Profile page under the Developer tab. New accounts start with free credits to try it without spending anything.

Quick facts

Model ID
hailuo-2.3-pro
Provider
MiniMax via KIE.ai
Cost
Tiered
Outputs per call
1

How to use it

Once the MCP is installed, you can ask Claude Code naturally. It'll pick Hailuo 2.3 Pro from the model-selection rubric in the tool description when your prompt matches its strengths (realistic human motion video).

Example interaction:

You
Generate animating real or ai-generated human characters

Claude Code calls aetherwave_generate_video with model: "hailuo-2.3-pro" and returns the finished asset URL. The result auto-saves to your AetherWave gallery (Cloudflare R2 hosted, no URL expiration).

Sample prompts that work well

Example 1
"Animate this portrait with subtle breathing and a slight smile"
Example 2
"Make this character walk forward naturally, full body shot, 6 seconds"
Example 3
"Subtle dance motion for this character, casual rhythm"

When to pick Hailuo 2.3 Pro

Hailuo 2.3 Pro shines for:

How it compares

vs grok-imagine-i2v at 4 cr/s: Hailuo is more expensive (63 cr for 6s) but vastly better at realistic human motion specifically. Pick Hailuo when humans are the subject; Grok for everything else.

Run aetherwave_list_video_models from Claude Code to see the full live catalog with pricing.

Cost

Tiered pricing by duration and resolution. 63 credits for 6 seconds at 768P. Higher tiers for longer or larger output. Specialized in realistic human motion.

Credits come from your AetherWave account. Plans:

Frequently Asked Questions

How do I install AetherWave MCP in Claude Code?

One command (shown above). Then restart Claude Code. The agent will have Hailuo 2.3 Pro available as part of the aetherwave_generate_video tool with 1 output(s) per call.

How do I use Hailuo 2.3 Pro from Claude Code?

Just describe what you want. The agent picks Hailuo 2.3 Pro when your prompt matches its strengths (realistic human motion video). You can also explicitly request it by passing model: "hailuo-2.3-pro" in the tool call.

What does Hailuo 2.3 Pro cost per generation?

Tiered pricing by duration and resolution. 63 credits for 6 seconds at 768P. Higher tiers for longer or larger output. Specialized in realistic human motion. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try Hailuo 2.3 Pro from Claude Code

Free API key, free starter credits, single MCP install. Be running your first Hailuo 2.3 Pro generation in under five minutes.

Get Your Free API Key