Hailuo 2.3 - video generation API

Hailuo 2.3 API

active

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

MiniMaxvideo30 credits/call
Provider
MiniMax
Pricing
30–85 credits per video (~$0.06–$0.17)
Speed
60–120 seconds
Output
video

Quick Start

Send a request to the Hailuo 2.3 API:

bash
1curl -X POST https://apiin.one/api/v1/videos/generations \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "hailuo/2-3-image-to-video-standard",
6 "prompt": "A golden retriever running through a sunflower field at sunset, slow motion",
7 "image": "https://example.com/golden-retriever.jpg",
8 "duration": "6",
9 "resolution": "768P"
10}'

API Endpoint

POST/api/v1/videos/generations

Send a POST request with your API key to generate content using Hailuo 2.3.

Headers

Body ParametersJSON
Authorization:string

Bearer YOUR_API_KEY

Content-Type:string

application/json

Body Parameters

Body ParametersJSON
model:string

Model identifier: hailuo-2-3

prompt:string

Text description of the video to generate

image:string

Reference image URL for image-to-video generation

model:optional string

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

duration:optional string

Video duration: 6 or 10 seconds Defaults to 6.

resolution:optional string

Output resolution: 768P or 1080P Defaults to 768P.

Example Request

json
1{
2 "model": "hailuo/2-3-image-to-video-standard",
3 "prompt": "A golden retriever running through a sunflower field at sunset, slow motion",
4 "image": "https://example.com/golden-retriever.jpg",
5 "duration": "6",
6 "resolution": "768P"
7}

Example Response

Successful task creation response.

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n51xxxx_hailuo",
6 "status": "IN_PROGRESS"
7 }
8}

Check Task Status

For asynchronous tasks, poll the status endpoint to check when your task is complete:

GET/api/v1/tasks/{task_id}

Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.

bash
1curl https://apiin.one/api/v1/tasks/task_abc123 \
2 -H "Authorization: Bearer aio_your_key"

Use Cases

  • Create short-form video content for social media marketing
  • Animate product photos into dynamic marketing videos
  • Build AI video generation into your creative workflow tools
  • Animate still images into dynamic video clips

API Tester

Test the Hailuo 2.3 API directly from your browser:

API 테스트 환경POST

Error Codes

1{
2 "error": {
3 "code": 400,
4 "message": "Invalid parameters",
5 "type": "invalid_request"
6 }
7}

Frequently Asked Questions

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.

Why Use Hailuo 2.3 Through API in One?

1.No separate MiniMax account needed
2.Cinematic motion quality rivaling top-tier models
3.Unified billing with 50+ other AI models
4.Webhook support for async completion

Ready to use Hailuo 2.3?

Get Your API Key →