Hailuo 2.3 API
activeHigh-quality AI video generation by MiniMax. Supports image-to-video with standard and pro quality modes, cinematic motion quality.
Quick Start
Send a request to the Hailuo 2.3 API:
| 1 | curl -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
/api/v1/videos/generationsSend a POST request with your API key to generate content using Hailuo 2.3.
Headers
Bearer YOUR_API_KEY
application/json
Body Parameters
Model identifier: hailuo-2-3
Text description of the video to generate
Reference image URL for image-to-video generation
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.
Video duration: 6 or 10 seconds Defaults to 6.
Output resolution: 768P or 1080P Defaults to 768P.
Example Request
| 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:
/api/v1/tasks/{task_id}Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.
| 1 | curl 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:
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?
Ready to use Hailuo 2.3?
Get Your API Key →
