POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 const axios = require('axios'); const FormData = require('form-data'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/hailuo-2.3"; const reqBody = { "prompt": "A young woman in yoga attire balances gracefully in tree pose on a rock by a serene lake, surrounded by wildflowers and soft morning light. She slowly shifts her arms overhead, transitions through gentle stretches and flows, framed by sun rays filtering through the tree, with calm water and distant mountains in the background.", "duration": 6, "resolution": "768p", "prompt_optimizer": true, "first_frame_image": "https://segmind-resources.s3.amazonaws.com/output/29539533-f96d-4d18-ad41-71a17f06d160-44c1380a-3513-40b6-b085-bc2cd3cc5477.png" }; (async function() { try { const formData = new FormData(); // Append regular fields for (const key in reqBody) { if (reqBody.hasOwnProperty(key)) { formData.append(key, reqBody[key]); } } // Convert and append images as Base64 if necessary const response = await axios.post(url, formData, { headers: { 'x-api-key': api_key, ...formData.getHeaders() } }); console.log(response.data); } catch (error) { console.error('Error:', error.response ? error.response.data : error.message); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


promptstr *

Customizes video content; use for creative scenarios or instructional content.


durationenum:int ( default: 6 )

Controls video length; choose 6 for brief clips or 10 for longer videos.

Allowed values:


resolutionenum:str ( default: 768p )

Determines video clarity; use 768p for standard quality, 1080p for high definition.

Allowed values:


prompt_optimizerbool ( default: true )

Enhances prompt execution; true optimizes outputs, false for basic generation.


first_frame_imagestr ( default: 1 )

Sets video aspect ratio; link to an image with desired dimensions.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Hailuo 2.3: Advanced Text-to-Video Generation Model

Edited by Segmind Team on October 28, 2025.

What is Hailuo 2.3?

Hailuo 2.3 from MiniMax is an advanced text-to-video model that transforms text prompts into fluid videos that are highly realistic. It works exceptionally well in producing lively character movements enhanced by photorealistic lighting and shadows. It supports a rich variety of artistic styles, including detailed realism to anime and traditional ink wash painting. It is an invaluable creation tool for artists, content creators, and professionals who want to design highly expressive and visually stunning videos, making it the perfect option because it can effectively capture even subtle facial micro-expressions and precise motion control.

Key Features of Hailuo 2.3

  • Photorealistic lighting and shadow rendering
  • Fluid character movements and natural motion transitions
  • Multiple artistic style support: realistic, anime, ink wash
  • Enhanced facial micro-expression generation
  • Flexible resolution options: 768p and 1080p
  • Customizable video duration: 6 or 10 seconds
  • Built-in prompt optimization system
  • Custom aspect ratio support via the first frame image

Best Use Cases

  • It is perfect for creative storytelling and narrative videos
  • It can create e-commerce product demonstrations
  • It can generate professional marketing and advertising content
  • It supports character animation and motion studies
  • It can design architectural and urban environment visualization
  • It is optimum for creating educational and instructional content
  • It can render digital art and multimedia installations

Prompt Tips and Output Quality

  • Prompts should have clear scene descriptions and include the desired artistic style
  • Provide specific lighting and atmosphere details for better realism
  • Use the prompt optimizer for enhanced output quality
  • Clearly specify movement and transitions in your prompts
  • For best results in professional scenarios, use 1080p resolution
  • Set the 'first_frame_image' parameter to maintain consistent aspect ratios
  • Leverage the 10-second duration for complex narrative sequences

FAQs

How does Hailuo 2.3 handle different artistic styles?

Hailuo 2.3 seamlessly adapts to various styles, from photorealistic to anime and ink wash painting, while maintaining consistency throughout the video generation.

What resolution options are available?

Hailuo 2.3 supports 768p for standard quality and 1080p for high-definition output, suitable for different use cases and requirements.

How can I optimize video quality?

For the best quality, enable the prompt_optimizer parameter, use detailed prompts, and select 1080p resolution. You can also guide the aspect ratio and composition by using a first frame image.

What's the maximum video duration?

The model offers two duration options: 6 seconds for quick clips and 10 seconds for more elaborate sequences; you can select the desired length via the duration parameter.

Can I control specific character movements?

Yes, the model generates the best visual outputs when it is provided with prompts that include detailed motion commands for precise control over character movements and transitions.

How does the prompt optimizer work?

The prompt optimizer automatically refines the input for enhanced prompt execution to get better video generation; you can also disable it for more control over the creative process.