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

# MiniMax-H3

> MiniMax H3 多模态视频生成与任务查询 API。

MiniMax-H3 是 MiniMax 的多模态视频生成模型。通过 AnyFast 使用 `POST /v2/video_generation` 创建视频生成任务，再使用 `GET /v2/query/video_generation/{task_id}` 查询任务结果。

## 核心能力

* **文生视频** — 根据文本提示生成视频。
* **图生视频** — 使用首帧、尾帧或首尾帧图片生成视频。
* **多模态参考生视频** — 将文本与参考图片、视频和音频组合使用。
* **2K 输出** — 支持官方 `2K` 分辨率。
* **任务式生成** — 创建接口返回任务 ID，生成过程通过查询接口轮询。

## 模型 ID

请求体中的模型 ID 使用 `MiniMax-H3`。

## 快速示例

创建一个文生视频任务：

```bash cURL theme={null}
curl --request POST \
  --url https://www.anyfast.ai/v2/video_generation \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去。"
      }
    ],
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9"
  }'
```

响应会返回 `task_id`：

```json theme={null}
{
  "task_id": "424010985738629"
}
```

创建任务后查询任务：

```bash cURL theme={null}
curl --request GET \
  --url https://www.anyfast.ai/v2/query/video_generation/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## 请求内容

`content` 数组可以包含 `text`、`image_url`、`video_url` 和 `audio_url`。媒体文件需要使用公开可访问的 URL，不支持 Base64。媒体内容可以通过 `role` 指定用途，例如 `first_frame`、`last_frame`、`reference_image`、`reference_video` 和 `reference_audio`。

## 参数限制

* `resolution` 当前支持 `2K`。
* `duration` 为 4 到 15 秒之间的整数。
* `ratio` 支持 `adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4` 和 `9:16`。文生视频必须显式指定比例；图生视频会使用输入图片比例。
* 请求体总大小不能超过 64 MB。
* 图片支持 JPG、JPEG、PNG、WEBP、HEIC 和 HEIF。单张图片不超过 30 MB，宽高范围为 256 至 5760 像素，宽高比范围为 0.4 至 2.5。
* 参考视频支持 MP4 和 MOV，视频编码支持 H.264 或 H.265，音频编码支持 AAC 或 MP3。单个视频不超过 50 MB、时长为 2 至 15 秒，视频总时长不超过 15 秒。
* 参考音频支持 WAV 和 MP3。单个音频不超过 15 MB、时长为 2 至 15 秒，音频总时长不超过 15 秒。

## 查询任务状态

查询响应中的状态包括 `queued`、`running`、`succeeded`、`failed` 和 `expired`。任务成功后，使用 `task.content.url` 获取生成的视频。

<Card title="API 参考" icon="code" href="/zh/api-reference/model-api/minimax/minimax-h3">
  查看 MiniMax-H3 的创建任务和查询任务接口参考。
</Card>

<script src="/public/feedback.js" />