# minimax/hailuo-02/i2v-standard
> Hailuo 02 is a new AI video generation model from Hailuo AI.
## Overview
- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateVideo` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `minimax/hailuo-02/i2v-standard`
## API Information
This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.
### Input Schema
The API accepts the following input parameters:
- **`model`** (`string`, _required_):
model name
- Default: `"minimax/hailuo-02/i2v-standard"`
- **`prompt`** (`string`, _optional_):
Generate a description of the video.
- Default: `"The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion"`
- **`image`** (`string`, _required_):
The model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB.
- Default: `"https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg"`
- **`duration`** (`integer`, _optional_):
The duration of the generated media in seconds.
- Default: `6`
- Options: 6, 10
- **`enable_prompt_expansion`** (`boolean`, _optional_):
The model automatically optimizes incoming prompts to enhance output quality. This also activates the safety checker, which ensures content safety by detecting and filtering potential risks.
- Default: `false`
**Required Parameters Example**:
```json
{
"model": "minimax/hailuo-02/i2v-standard",
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg"
}
```
**Full Example**:
```json
{
"model": "minimax/hailuo-02/i2v-standard",
"prompt": "The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion",
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg",
"duration": 6,
"enable_prompt_expansion": false
}
```
### Output Schema
The API returns the following output format:
- **`id`** (`string`, _optional_):
Unique identifier for the prediction, the ID of the prediction to get.
- **`urls`** (`object`, _optional_):
Object containing related API endpoints.
- **`model`** (`string`, _optional_):
Model ID used for the prediction.
- **`status`** (`string`, _optional_):
Status of the task: created, processing, completed, or failed.
- **`outputs`** (`array[string]`, _optional_):
Array of URLs to the generated content (empty when status is not completed).
- **`created_at`** (`string`, _optional_):
ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”).
- **`has_nsfw_contents`** (`array[boolean]`, _optional_):
Array of boolean values indicating NSFW detection for each output.
**Example Response**:
```json
{
"id": "",
"urls": {},
"model": "",
"status": "",
"outputs": [
""
],
"created_at": "",
"has_nsfw_contents": []
}
```
## Usage Examples
### cURL
```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax/hailuo-02/i2v-standard",
"prompt": "The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion",
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg",
"duration": 6,
"enable_prompt_expansion": false
}'
# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}
# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY"
# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```
## Additional Resources
### Documentation
- [Model Playground](https://www.atlascloud.ai/models/minimax/hailuo-02/i2v-standard)
