Hailuo 2.3 iconVideo 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.

Real routes1Real endpoint rows linked to this model.
Endpoint models8Live models sharing this endpoint.
Base cost30 credits$0.30 · 60–120 seconds
Endpoint familyVideo API/api/v1/videos/generations
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.

Service highlights

Marketplace-style signals backed by the current live route, without copying external SLA, discount, login, or payment claims.

Live production route

This page only shows endpoints implemented under /api/v1. /api/v1/videos/generations

Webhook / polling

Use callback_url when supported, or poll the task status route for results.

Shared billing system

Top-up, orders, credit balance, and profile continue through the existing shared console.

Managed provider credentials

Your browser only holds an API in One key; provider calls stay server-side.

Call contract

Use these fields to integrate the current live model route.

Base URL
https://apiin.one
Clients call same-origin APIs; the server BFF forwards to the Worker.
Authorization
Authorization: Bearer <API_KEY>
Managed by the existing Dashboard API Keys page.
Model field
hailuo-2-3
Send this value in the request body model field.
Result path
/api/v1/tasks/{task_id}
Async jobs return task_id, then use status polling.
Billing path
/billing/credits
Uses the existing credits, orders, and top-up logic.

Runtime behavior

This model creates an async task, returns a task_id, then resolves through the real status route.

Client request/api/v1/videos/generationstask_id -> result
View usage logs

API Console

Switch between real models on this endpoint, choose a live route, and generate request examples from the current catalog payload.

Live model8 live models
Endpoint1 Routes
ProviderMiniMaxhttps://n51.gogloai.com
Current cost30 credits · $0.3030–85 credits per video (~$0.30–$0.85)
RuntimeAsync taskAsync jobs return task_id, then use status polling.
Input / outputimage -> videoUse callback_url when supported, or poll the task status route for results.
Backend nodenode51Your browser only holds an API in One key; provider calls stay server-side.
Request previewPOST /api/v1/videos/generations
curl --request POST \
  --url https://apiin.one/api/v1/videos/generations \
  --header 'Authorization: Bearer <API_KEY>'
  --header '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"
}'
Result path/api/v1/tasks/{task_id}
Open docs

Endpoint decision panel

Evaluate cost, provider coverage, and production integration behavior across live models on this implemented endpoint.

Endpoint models8These models share the same BFF route and switch through the model field.
Provider coverage8Real provider sources currently exposed by this endpoint.
Cost range24-300 credits$0.24-$3.00 · Based on the current live catalog base credit cost.
Webhook coverage5/8Models on this endpoint that support callback_url.
Current model position4/8

Sorted by base credits from low to high.

Lowest-cost route in this endpointgrok-video

xAI · 24 credits · $0.24

Production patternAsync task + webhook/polling

Use callback_url when supported, or poll the task status route for results.

Live capabilities

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

Use the same API in One key as the rest of the routed catalog

Use the same API in One key as the rest of the routed catalog

Cinematic motion quality rivaling top

Cinematic motion quality rivaling top-tier models

Unified billing with all other live models

Unified billing with all other live models

Webhook support for async completion

Webhook support for async completion

Request format

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

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.

Endpoint model comparison

Compare real models behind this implemented route by cost, provider, runtime mode, input, output, and backend node.

Integration flow

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

01

Create a shared API key

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

02

Call the real endpoint

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

03

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.

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.

Related live models