> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Minimax Hailuo-02

Minimax Hailuo-02 是一款支持文本生成视频和图片生成视频的AI视频生成模型。它可以生成 6秒的 768P 或 1080P 分辨率视频，以及 10秒的 768P 分辨率视频。

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 来检索视频生成结果。
</Tip>

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="prompt" type="string" required={true}>
  指导生成所需的提示词文本。

  范围: `1 <= x <= 2000`。
</ParamField>

<ParamField body="image" type="string" required={false}>
  用于视频生成的首帧图片。支持公网 URL 或 Base64 编码（如 `data:image/jpeg;base64,...`）。
</ParamField>

<ParamField body="end_image" type="string" required={false}>
  用于视频生成的结束帧图片。支持公网 URL 或 Base64 编码（如 `data:image/jpeg;base64,...`）。
</ParamField>

<ParamField body="duration" type="integer" required={false}>
  生成视频的时长（秒）。默认值：`6`<br />
  可选值：`6`、`10`
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  生成视频的分辨率。默认值：`768P`

  * 6 秒视频支持：`768P`、`1080P`
  * 10 秒视频仅支持：`768P`
</ParamField>

<ParamField body="enable_prompt_expansion" type="boolean" required={false}>
  是否启用提示词优化。

  默认值: `true`。
</ParamField>

<ParamField body="fast_pretreatment" type="boolean" required={false} default={false}>
  是否缩短提示词优化的耗时。

  默认值: `false`。
</ParamField>

<ParamField body="aigc_watermark" type="boolean" required={false} default={false}>
  为生成的视频添加水印。

  * `false`：不添加水印。
  * `true`：在视频添加文字的水印，标识由人工智能生成合成。
</ParamField>

## 响应

<ResponseField name="task_id" type="string" required={true}>
  异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 以获取生成结果
</ResponseField>

## 示例

以下是如何使用 Minimax Hailuo-02 API 的示例。

1. 通过向 Minimax Hailuo-02 API 发送 POST 请求来生成 task\_id。

`请求:`

```bash theme={null}
curl \
-X POST https://api.ppio.com/v3/async/minimax-hailuo-02 \
-H "Authorization: Bearer $your_api_key" \
-H "Content-Type: application/json" \
-d '{
  "image": "https://static.ppinfra.com/docs/assets/minimax-hailuo-video-02-input-image.jpg",
  "prompt": "戴着太阳镜的毛茸茸的熊猫在日出时的雪山顶上跳舞，左移运镜",
  "duration": 6,
  "resolution": "768P",
  "enable_prompt_expansion": true
}'
```

`响应:`

```js theme={null}
{
    "task_id": "{返回的 Task ID}"
}
```

2. 使用 `task_id` 获取输出视频。

2xx 范围内的 HTTP 状态码表示请求已成功接受，而 5xx 范围内的状态码表示内部服务器错误。

您可以在响应的 `videos` 字段中获取视频 url。

`请求:`

```bash theme={null}
curl --location --request GET 'https://api.ppio.com/v3/async/task-result?task_id={返回的 Task ID}' \
--header 'Authorization: Bearer {{API Key}}'
```

`响应:`

```js theme={null}
{
    "task": {
        "task_id": "{返回的 Task ID}",
        "task_type": "MINIMAX_HAILUO_02",
        "status": "TASK_STATUS_SUCCEED",
        "reason": "",
        "eta": 0,
        "progress_percent": 100
    },
    "images": [],
    "videos": [
        {
            "video_url": "{生成视频的 URL}",
            "video_url_ttl": "3600",
            "video_type": "mp4"
        }
    ]
}
```

`视频文件:`

<video controls className="w-full aspect-video" src="https://static.ppinfra.com/docs/assets/minimax-hailuo-video-02-result.mp4" />