LogoAPI in One
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
curl -X POST https://apiin.one/api/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo/2-3-image-to-video-standard",
  "prompt": "A golden retriever running through a sunflower field at sunset, slow motion",
  "image": "https://example.com/golden-retriever.jpg",
  "duration": "6",
  "resolution": "768P"
}'

API Endpoint

POST/api/v1/videos/generations
Send a POST request with your API key to generate content using Hailuo 2.3.

Headers

Header유형필수설명
Authorizationstring필수Bearer YOUR_API_KEY
Content-Typestring필수application/json

Body Parameters

매개변수유형필수설명
modelstring필수Model identifier: "hailuo-2-3"
promptstring필수Text description of the video to generate
imagestring필수Reference image URL for image-to-video generation
modelstring선택 사항Sub-model: "hailuo/2-3-image-to-video-standard" (30–45cr) or "hailuo/2-3-image-to-video-pro" (45–85cr) (기본값: hailuo/2-3-image-to-video-standard)
durationstring선택 사항Video duration: "6" or "10" seconds (기본값: 6)
resolutionstring선택 사항Output resolution: "768P" or "1080P" (기본값: 768P)

Example Request

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

Example Response

Successful task creation response.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n51xxxx_hailuo",
    "status": "IN_PROGRESS"
  }
}

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
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -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

{
  "error": {
    "code": 400,
    "message": "Invalid parameters",
    "type": "invalid_request"
  }
}

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?

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

Ready to use Hailuo 2.3?

Get Your API Key →