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

HeaderTipoObrigatórioDescrição
AuthorizationstringObrigatórioBearer YOUR_API_KEY
Content-TypestringObrigatórioapplication/json

Body Parameters

ParâmetroTipoObrigatórioDescrição
modelstringObrigatórioModel identifier: "hailuo-2-3"
promptstringObrigatórioText description of the video to generate
imagestringObrigatórioReference image URL for image-to-video generation
modelstringOpcionalSub-model: "hailuo/2-3-image-to-video-standard" (30–45cr) or "hailuo/2-3-image-to-video-pro" (45–85cr) (Padrão: hailuo/2-3-image-to-video-standard)
durationstringOpcionalVideo duration: "6" or "10" seconds (Padrão: 6)
resolutionstringOpcionalOutput resolution: "768P" or "1080P" (Padrão: 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:

Playground da APIPOST

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 →