# Hailuo 2.3 Fast

> Transform text and images into professional-quality videos at lightning speed.


## Overview

- **Endpoint**: `https://api.segmind.com/v1/hailuo-2.3-fast`
- **Model ID**: `hailuo-2.3-fast`
- **Category**: Image-to-Video Generation
- **Type**: Synchronous (Direct response)
- **Average Latency**: ~92.3s (30-day average)

- **Average Cost**: $0.2409 per run (observed across past runs, not a price — see Pricing)
- **Provider**: REPLICATE



## Pricing

| resolution | duration | cost |
| --- | --- | --- |
| 768p | 6 | 0.24 |
| 768p | 10 | 0.4 |
| 1080p | 6 | 0.41 |

## API Information

This model uses a **synchronous response pattern**:
1. Make a POST request with your parameters
2. Receive the output directly in the response (binary for images/videos/audio, JSON for text)
3. No polling required - response is immediate


### Input Schema

The API accepts the following input parameters:

- **`prompt`** (`string`, _required_):
  Prompt
  The text description used for content creation. Use detailed text for unique scenes or abstract for artistic videos.

- **`first_frame_image`** (`File (URL)`, _required_):
  First Frame Image
  Sets initial image for video, affecting screen ratio. Use a themed image for cohesive videos.

- **`prompt_optimizer`** (`boolean`, _optional_):
  Prompt Optimizer
  Enhances prompt quality for improved results. Enable for complex prompts, disable for simpler tasks.
  - Default: `true`

- **`duration`** (`integer`, _optional_):
  Duration
  Defines video length in seconds. Use 6 for short clips, 10 for more detailed scenes. 10 seconds is only available at 768p.
  - Default: `6`
  - Options: "6" (6), "10" (10)

- **`resolution`** (`string`, _optional_):
  Resolution
  Sets video quality. Choose 768p for faster processing, 1080p for high detail.
  - Default: `"768p"`
  - Options: "768p" (768p), "1080p" (1080p)


**Required Parameters Example**:

```json
{
  "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.",
  "first_frame_image": "https://segmind-resources.s3.amazonaws.com/input/a1f4d83b-62f9-4842-91c7-2af871836dd6-hailuo-2.3-fast.jpg"
}
```


**Full Example**:

```json
{
  "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.",
  "first_frame_image": "https://segmind-resources.s3.amazonaws.com/input/a1f4d83b-62f9-4842-91c7-2af871836dd6-hailuo-2.3-fast.jpg",
  "prompt_optimizer": true,
  "duration": 6,
  "resolution": "768p"
}
```


### Output Schema

The API returns a synchronous response based on the model type:

**For Image/Video/Audio Models**:
- Response contains binary data (image/png, video/mp4, audio/mp3)
- Content-Type header indicates the media type
- Save the response body directly to a file

**For Text Models**:
- Response is JSON with the generated text
- Structure varies by model

**HTTP Response Codes**:
- **200 - OK**: Request successful, output in response body
- **400 - Bad Request**: Invalid parameters
- **401 - Unauthorized**: Invalid or missing API key
- **404 - Not Found**: Model not found
- **406 - Not Acceptable**: Insufficient credits
- **429 - Too Many Requests**: Rate limit exceeded
- **500 - Server Error**: Internal server error



## About

### 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

## Usage Guide

```markdown
# Hailuo 2.3 Fast: Guide to Effective Use

Hailuo 2.3 Fast is a next-generation text-to-video model that delivers professional-quality clips up to 2.5× faster than previous versions. Whether you’re building social media teasers, marketing promos, or cinematic sequences, this guide will help you choose the right settings and craft optimal prompts for every scenario.

## 1. Getting Started

1. Define your creative goal (e.g., product showcase, character animation, abstract art).  
2. Prepare a high-quality initial frame image (JPEG/PNG URL) that matches your scene’s aspect ratio and aesthetic.  
3. Decide on video length:
   - **6 seconds**: Quick transitions, social media snippets, rapid prototyping  
   - **10 seconds**: More complex narratives, detailed camera moves  

4. Choose resolution:
   - **768p** for fast iterations and drafts  
   - **1080p** for full-detail, professional output  

5. Enable the **Prompt Optimizer** for intricate scenes; disable for straightforward concepts.

## 2. Parameter Recommendations by Use Case

Use case               | Duration | Resolution | Prompt Optimizer | Example first_frame_image
-----------------------|----------|------------|------------------|--------------------------
Social Media Clips     | 6 sec    | 768p       | false            | Bright, branded product shot
Marketing Promos       | 10 sec   | 1080p      | true             | High-res product lifestyle image
Cinematic Sequences    | 10 sec   | 1080p      | true             | Wide-angle landscape frame
Character Animations   | 6 sec    | 1080p      | true             | Close-up character portrait
Corporate Presentations| 10 sec   | 1080p      | false            | Branded slide template

## 3. Crafting Powerful Prompts

- Start with a concise scene description: “A sleek electric car glides through neon city streets at dusk.”  
- Specify motion cues: “Camera pans up, then does a 360° orbit around the vehicle.”  
- Add atmosphere and lighting: “Soft golden backlight, light rain reflections on asphalt.”  
- Include transitions: “Cut to interior shot revealing futuristic dashboard display.”  
- Keep prompts under 100 words for clarity but pack in vivid details.

## 4. Best Practices

- Always preview your first frame image to verify alignment with the prompt.  
- For rapid prototyping, disable the prompt optimizer and use 768p.  
- In production, enable the optimizer, choose 1080p, and lean on the 10-second duration.  
- Use consistent naming conventions and version tags when exporting multiple takes.  
- Review and refine your prompt after each render to converge on your vision.

## 5. Troubleshooting

- Blurry motion? Increase resolution or shorten duration.  
- Incoherent transitions? Simplify prompt steps or toggle optimizer off.  
- Facial artifacts? Supply a high-quality, close-up first frame image.  
- Color shifts? Mention “consistent color grading” or “cinematic LUT” in your prompt.

With these guidelines, you’ll unlock the full power of Hailuo 2.3 Fast—creating eye-catching, high-quality videos in record time. Enjoy your creative journey!  
```

## FAQ

### 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.

## Usage Examples

### cURL

```bash
curl -X POST "https://api.segmind.com/v1/hailuo-2.3-fast" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "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.",
  "first_frame_image": "https://segmind-resources.s3.amazonaws.com/input/a1f4d83b-62f9-4842-91c7-2af871836dd6-hailuo-2.3-fast.jpg",
  "prompt_optimizer": true,
  "duration": 6,
  "resolution": "768p"
}'
```

### Python

```python
import requests
import json

api_key = "YOUR_API_KEY"
url = "https://api.segmind.com/v1/hailuo-2.3-fast"

data = {
  "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.",
  "first_frame_image": "https://segmind-resources.s3.amazonaws.com/input/a1f4d83b-62f9-4842-91c7-2af871836dd6-hailuo-2.3-fast.jpg",
  "prompt_optimizer": true,
  "duration": 6,
  "resolution": "768p"
}

response = requests.post(
    url,
    json=data,
    headers={
        'x-api-key': api_key,
        'Content-Type': 'application/json'
    }
)

if response.status_code == 200:
    # For image/video/audio models, response.content contains the binary data
    with open('output.png', 'wb') as f:
        f.write(response.content)
    print('Generation complete, saved to output.png')
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

### JavaScript

```javascript
const apiKey = 'YOUR_API_KEY';
const url = 'https://api.segmind.com/v1/hailuo-2.3-fast';

const data = {
  "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.",
  "first_frame_image": "https://segmind-resources.s3.amazonaws.com/input/a1f4d83b-62f9-4842-91c7-2af871836dd6-hailuo-2.3-fast.jpg",
  "prompt_optimizer": true,
  "duration": 6,
  "resolution": "768p"
};

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'x-api-key': apiKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(data),
});

if (response.ok) {
  // For image/video/audio models, response contains binary data
  const blob = await response.blob();
  const downloadUrl = URL.createObjectURL(blob);

  // Create download link
  const a = document.createElement('a');
  a.href = downloadUrl;
  a.download = 'output.png';
  a.click();

  console.log('Generation complete');
}
```


## Additional Resources

### Documentation

- [Model Playground](https://www.segmind.com/models/hailuo-2.3-fast)
- [API Documentation](https://www.segmind.com/models/hailuo-2.3-fast/api)
- [Pricing Details](https://www.segmind.com/models/hailuo-2.3-fast/pricing)
- [Platform Documentation](https://docs.segmind.com/)