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-fast"; const reqBody = { "prompt": "A woman stands outdoors in soft sunlight, modeling a blue floral knit cardigan over white pants. She gently poses with relaxed confidence, running her hand through her flowing hair as the camera slowly pans around, highlighting the sweater’s floral pattern against a natural garden background.", "duration": 6, "resolution": "1080p", "prompt_optimizer": true, "first_frame_image": "https://segmind-resources.s3.amazonaws.com/input/a1f4d83b-62f9-4842-91c7-2af871836dd6-hailuo-2.3-fast.jpg" }; (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 *

The text description used for content creation. Use detailed text for unique scenes or abstract for artistic videos.


durationenum:int ( default: 6 )

Defines video length in seconds. Use 6 for short clips, 10 for more detailed scenes.

Allowed values:


resolutionenum:str ( default: 1080p )

Sets video quality. Choose 768p for faster processing, 1080p for high detail.

Allowed values:


prompt_optimizerbool ( default: true )

Enhances prompt quality for improved results. Enable for complex prompts, disable for simpler tasks.


first_frame_imagestr *

Sets initial image for video, affecting screen ratio. Use a themed image for cohesive videos.

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 Fast: Text-to-Video Generation Model

Edited by Segmind Team on October 30, 2025.

What is Hailuo 2.3 Fast?

Hailuo 2.3 Fast is a sophisticated AI model that generates premium videos from images, using descriptive text prompts. It is built for efficiency in speed and precision; therefore, it can deliver content up to 2.5 times faster than previous visual iterations without compromising on essential details or quality. The model combines advanced motion mapping and facial expression technology for smooth, lifelike animations that are essential for a myriad of professional arenas.

Key Features of Hailuo 2.3 Fast

  • It offers 2.5x speed faster than previous visual iterations for a lightning-fast video rendering
  • It supports 768p and 1080p resolution outputs
  • It includes an advanced prompt optimization system for enhanced results
  • It has seamless integration of text prompts and initial frame images
  • It has a customizable video duration: 6 or 10 seconds
  • It is integrated with precise motion mapping and realistic facial expressions
  • It is capable of professional-grade output quality for commercial use

Best Use Cases

  • Social Media Content Creation: It is perfect for quick, engaging clips for platforms like Instagram and TikTok
  • Marketing Videos: It can be used to create professional promotional content for products and services
  • Cinematic Scene Generation: It can produce short film sequences and visual effects
  • Animation Projects: It can design character animations and abstract visual stories
  • Corporate Communications: It can be used to design professional presentations and branded content
  • Content Prototyping: It is ideal for rapid visualization of creative concepts

Prompt Tips and Output Quality

  • Provide prompts that include clear scene descriptions and desired movement patterns
  • Include precise details about lighting, atmosphere, and transitions
  • To generate complex scenes with nuanced interpretation, use the prompt optimizer
  • Select 1080p resolution for detailed, professional outputs
  • Choose 768p resolution when quick iterations are needed
  • Provide initial images with relevant themes to match your desired aesthetic
  • Opt for video durations based on content complexity: 6s for simple transitions and 10s for detailed narratives

FAQs

How does Hailuo 2.3 Fast compare to other video generation models?

Hailuo 2.3 Fast offers unmatched ultra fast rendering 2.5x speeds, while maintaining professional-quality output. It is tailored for commercial and creative uses.

What's the recommended workflow for best results?

Input a detailed prompt to the model, then enable the prompt optimizer for complex scenes, ensure you use a high-quality initial frame image, and select the resolution based on your use case, i.e., 1080p for detail or 768p for speed.

Can I control the video duration?

Yes, you can choose the video duration between 6 and 10 seconds. 6 seconds is perfect for simple transitions and social media content, while 10 seconds works well for complex narratives.

How does the prompt optimizer work?

The 'prompt optimizer' improves the input by automatically refining and expanding your descriptions in the prompt for better results. You can use it for complex scenes and disable it during simpler tasks that work fine with direct interpretation.

What types of initial frame images work best? Select high-resolution images that depict your preferred starting point and match the desired aspect ratio. The image should also align with your prompt’s theme to ensure the rendered video is coherent and visually consistent.