Live capabilities

These capabilities come from the current model config and backend route. Unreleased APIs are not listed.

No separate MiniMax account needed

Cinematic motion quality rivaling top

Cinematic motion quality rivaling top-tier models

Unified billing with all other live models

Webhook support for async completion

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/videos/generations30 credits

High-quality AI video generation by MiniMax. Supports image-to-video with standard and pro quality modes, cinematic motion quality.

Parameters

promptstring

Text description of the video to generate

Required

imagestring

Reference image URL for image-to-video generation

Required

modelstring

Sub-model: "hailuo/2-3-image-to-video-standard" (30–45cr) or "hailuo/2-3-image-to-video-pro" (45–85cr)

Optional · Default hailuo/2-3-image-to-video-standard

durationstring

Video duration: "6" or "10" seconds

Optional · Default 6

resolutionstring

Output resolution: "768P" or "1080P"

Optional · Default 768P

Example request

{
  "endpoint": "/api/v1/videos/generations",
  "headers": {
    "Authorization": "Bearer <API_KEY>",
    "Content-Type": "application/json"
  },
  "body": {
    "model": "hailuo-2-3",
    "prompt": "A golden retriever running through a sunflower field at sunset, slow motion",
    "image": "https://example.com/golden-retriever.jpg",
    "duration": "6",
    "resolution": "768P"
  }
}

Task status route

After creating image, video, audio, or tool tasks, poll the real task endpoint for results.

GET/api/v1/tasks/{task_id}Check generation task status and result.

Pricing

30–85 credits per video (~$0.30–$0.85)

Base cost$0.30

Credits30

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

01

Create short-form video content for social media marketing

02

Animate product photos into dynamic marketing videos

03

Build AI video generation into your creative workflow tools

04

Animate still images into dynamic video clips

FAQ

How much does the Hailuo API cost?

Standard mode: 30 credits (6s 768P), 45 credits (10s or 1080P). Pro mode: 45–85 credits depending on duration and resolution.

What video lengths does Hailuo 2.3 support?

Hailuo 2.3 generates 6 or 10 second video clips at 768P or 1080P resolution.

What is the difference between standard and pro?

Pro mode produces higher quality videos with better motion fidelity. Standard mode is cheaper and still produces excellent results.

hailuo-2-3 API