Hailuo 2.3 API
Generate stunning videos from images with Hailuo 2.3 AI
Hailuo 2.3
Transform static images into dynamic videos with superior motion quality, lifelike expressions, anime styles, and e-commerce-ready content. Hailuo 2.3 from MiniMax excels at dance choreography, facial micro-expressions, and artistic styles.
Try it now: Use the Hailuo AI Generator to create videos from your images.
Pricing
| Variant | Duration | Resolution | Credits | Price (Pro Yearly) | Price (Pro Monthly) |
|---|---|---|---|---|---|
| Standard | 6s | 768P | 30 | $0.18 | $0.36 |
| Standard | 10s | 768P | 50 | $0.30 | $0.60 |
| Standard | 6s | 1080P | 50 | $0.30 | $0.60 |
| Pro | 6s | 768P | 50 | $0.30 | $0.60 |
| Pro | 10s | 768P | 100 | $0.60 | $1.20 |
| Pro | 6s | 1080P | 90 | $0.54 | $1.08 |
Note: 10-second videos at 1080P resolution are not supported.
Credits are deducted only on successful generation.
Endpoint
POST https://vicsee.com/api/v1/generateSee Authentication for API key setup.
Hailuo 2.3 Standard
Good motion quality for quick previews and iterations.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | hailuo-2-3-standard |
| prompt | string | Yes | Description of desired motion (max 5000 chars) |
| options.imageUrl | string | Yes | URL of the input image |
| options.duration | string | No | "6" or "10" (default: "6") |
| options.resolution | string | No | "768P" or "1080P" (default: "768P") |
Example Request
curl -X POST https://vicsee.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo-2-3-standard",
"prompt": "The character turns to face the camera with a gentle smile, hair flowing in the breeze",
"options": {
"imageUrl": "https://example.com/your-image.jpg",
"duration": "6",
"resolution": "768P"
}
}'Hailuo 2.3 Pro
Enhanced motion quality and better detail preservation for final production.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | hailuo-2-3-pro |
| prompt | string | Yes | Description of desired motion (max 5000 chars) |
| options.imageUrl | string | Yes | URL of the input image |
| options.duration | string | No | "6" or "10" (default: "6") |
| options.resolution | string | No | "768P" or "1080P" (default: "768P") |
Example Request
curl -X POST https://vicsee.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo-2-3-pro",
"prompt": "A dancer performs fluid ballet movements, arms extending gracefully, soft studio lighting",
"options": {
"imageUrl": "https://example.com/dancer.jpg",
"duration": "6",
"resolution": "1080P"
}
}'Input Image Requirements
- Formats: JPEG, PNG, WebP
- Max size: 10MB
- Recommendations: High-quality images with clear subjects work best
Tips for Best Results
Hailuo 2.3 excels at specific types of motion:
Dance & Body Movements:
- "The dancer performs hip-hop moves with precise footwork"
- "Character spins gracefully with arms extended"
Facial Expressions:
- "Subtle smile forms as eyes light up with joy"
- "Expression transitions from surprise to laughter"
Anime & Artistic Styles:
- "Anime character's hair flows dramatically in the wind"
- "Ink wash style landscape comes alive with floating petals"
E-commerce & Product:
- "Product rotates 360 degrees on turntable, smooth lighting"
- "Camera pans across product details from left to right"
Response
Success (200)
{
"taskId": "task_abc123xyz",
"status": "pending",
"model": "hailuo-2-3-pro",
"createdAt": "2025-12-30T12:00:00Z"
}Poll for completion using Tasks API.
Task Complete
{
"taskId": "task_abc123xyz",
"status": "completed",
"output": {
"url": "https://cdn.vicsee.com/outputs/video_xyz.mp4",
"duration": 6,
"resolution": "1080P",
"format": "mp4"
}
}