img_uuid, then poll the asynchronous job or handle status updates through a callback. GoEnhance provides third-party access and is not MiniMax or an official MiniMax API.Hailuo 2.3 API for Text and Image-to-Video
Access Hailuo 2.3 through the independent GoEnhance API. Submit a text prompt or add a first-frame image, receive an
Create an API Key
Choose the Hailuo 2.3 Generation Mode
Text-to-Video with hailuo_2_3
Send model: hailuo_2_3 with a required prompt. For text-only requests, the optional ratio field sets the output aspect ratio. Choose 768P for 6 or 10 seconds, or 1080P for a 6-second result.
Image-to-Video from a First Frame
Add an HTTPS image_url to use that asset as the first frame. The same endpoint and model ID handle the request, so one integration can support both prompt-only and first-frame workflows.
Validate mode, duration, and resolution together before sending a generation request.
Hailuo 2.3 API Parameters and Validation
Model and prompt
Set <code>model</code> to <code>hailuo_2_3</code>. A text <code>prompt</code> describing the video is required for every request.
Optional first-frame image
Provide <code>image_url</code> to run image-to-video. Omit it for text-to-video. The value must be a valid image URL accessible to the service.
Duration rules
The <code>duration</code> field accepts 6 or 10 seconds and defaults to 6. A 1080P request supports 6 seconds only.
Resolution options
Choose <code>768P</code> or <code>1080P</code>; the default is 768P. The 10-second option is available only at 768P.
Text-to-video ratio
Use the optional <code>ratio</code> field for text-to-video requests. Do not rely on it as a first-frame image override.
Asynchronous completion
A successful submission returns <code>img_uuid</code>. Poll <code>GET /api/v1/jobs/detail</code> or supply <code>custom_callback_url</code> for status updates.
GoEnhance lists pricing per video at $0.02 per token. Choose a valid resolution-and-duration pair before submission.
Hailuo 2.3 API Pricing
768P, 6 seconds — 18.2 tokens ($0.364)
This is the lowest listed Hailuo 2.3 API price for a complete video request.
768P, 10 seconds — 36.4 tokens ($0.728)
Use this tier when the application needs the longer supported duration at 768P.
1080P, 6 seconds — 31.85 tokens ($0.637)
Hailuo 2.3 supports 1080P at 6 seconds; 10-second 1080P requests are not supported.
Integrate the Hailuo 2.3 API
1
1. Create a key and build the request
Create an API key, keep it on your server, and send bearer authentication. POST to
https://api.goenhance.ai/api/v1/videos/generations with model: hailuo_2_3, a prompt, and a valid duration and resolution. 2
2. Save the returned img_uuid
Treat submission and generation as separate stages. Persist the returned
img_uuid with your own job record so retries and user sessions do not lose task identity. 3
3. Poll or process callbacks
Poll
GET /api/v1/jobs/detail, or provide a public HTTPS callback URL. GoEnhance posts status changes and retries a non-200 callback up to three times with a three-second timeout per attempt.Use the API where repeatable submission and asynchronous delivery matter more than a manual editor.
What Developers Build with Hailuo 2.3
Automated ad concepts
Turn approved campaign prompts into short video candidates and route each completed asset into a review queue.
Product image animation
Use a product still as the first frame to create motion-ready clips for catalog, launch, or presentation workflows.
Editorial and social pipelines
Connect structured prompts, async task tracking, callbacks, moderation, and storage for repeatable short-form production.
Answers about model inputs, Hailuo 2.3 API pricing, asynchronous jobs, callbacks, and MiniMax API positioning.