Video APIActive

hailuo-2-3 API

Generate cinematic AI videos with the Hailuo 2.3 API via API in One. Image-to-video generation with standard and pro modes. 30–85 credits per video.

Get API Key View Docs

Model IDhailuo-2-3

Use this in the request body model field.

Endpoint/api/v1/videos/generations

The currently implemented BFF route.

Outputvideo

Input types: image

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookSupported

Use callback_url on supported async tasks.

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

curl -X POST https://apiin.one/api/v1/videos/generations \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "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"
}'

Models on the same endpoint

These live models use the same implemented BFF endpoint and can be switched by changing the model field.

grok-videovideo · 24 credits/api/v1/videos/generations🎞️ltx-2video · 24 credits/api/v1/videos/generations

seedance-1-5-provideo · 28 credits/api/v1/videos/generations

wan-2-6video · 80 credits/api/v1/videos/generations

pixverse-5-6video · 90 credits/api/v1/videos/generations

kling-3video · 300 credits/api/v1/videos/generations

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/videos/generations

Poll task status

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

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.

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

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.