MiniMax-H3

MiniMax-H3 提供异步多模态视频生成能力。使用 POST /v2/video_generation 创建任务，再使用 GET /v2/query/video_generation/{task_id} 查询任务状态和结果。

创建视频生成任务
查询视频生成任务

创建任务

POST /v2/video_generation

cURL

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"
  }'

200

{
  "task_id": "424010985738629"
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

使用 MiniMax-H3。

object[]

必填

多模态内容数组，每项使用 text、image_url、video_url 或 audio_url。

string

必填

内容类型：text、image_url、video_url 或 audio_url。

string

文本提示词。视频生成必须包含文本内容。

string

媒体用途，例如 first_frame、last_frame、reference_image、reference_video 或 reference_audio。

string

公开图片 URL，不支持 Base64。

string

用于多模态参考输入的公开视频 URL。

string

用于多模态参考输入的公开音频 URL。

string

必填

当前支持 2K。

integer

必填

视频时长，4 到 15 秒之间的整数。

string

支持 adaptive、21:9、16:9、4:3、1:1、3:4 和 9:16。文生视频必须显式指定比例。

string

可选的任务状态回调地址。

boolean

默认值:"false"

是否添加 AIGC 水印。

内容规则

文生视频使用一个文本内容。
图生视频支持首帧、尾帧或首尾帧图片；同时提供首尾帧时使用 first_frame 和 last_frame 标记。
参考生视频可以组合参考图片、视频和音频，但至少需要一张参考图片或一个参考视频，不能只提供音频。
首尾帧标记不能与参考媒体标记混用。
请求体总大小不超过 64 MB。图片支持 JPG、JPEG、PNG、WEBP、HEIC 和 HEIF，单张图片不超过 30 MB。
参考视频支持 MP4/MOV、H.264/H.265 和 AAC/MP3，单个视频不超过 50 MB、时长为 2 到 15 秒。参考音频支持 WAV/MP3，单个音频不超过 15 MB、时长为 2 到 15 秒。

响应

string

视频生成任务 ID，用于查询任务状态。

查询任务

GET /v2/query/video_generation/{task_id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/v2/query/video_generation/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "task": {
    "id": "424010985738629",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785125529,
    "updated_at": 1785125946,
    "content": {
      "url": "https://cdn.hailuoai.com/example/video.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "image_count": 0
    },
    "ratio": "16:9",
    "task_type": "generation"
  }
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

路径参数

string

必填

创建任务接口返回的视频生成任务 ID。

响应字段

object

查询到的视频生成任务。

string

任务 ID。

string

任务使用的模型。

string

任务状态：queued、running、succeeded、failed 或 expired。

integer

任务创建时间，Unix 时间戳。

integer

任务更新时间，Unix 时间戳。

string

任务成功时生成的视频 URL。

string

输出分辨率。

integer

输出视频时长，单位为秒。

object

任务用量信息。

number

总计费或处理时长。

number

输入媒体时长，单位为秒。

number

输出视频时长，单位为秒。

integer

输入图片数量。

string

输出宽高比。

string

任务类型，例如 generation。

概览

原生兼容端点

模型 API

创建任务

请求头

请求参数

内容规则

响应

查询任务

请求头

路径参数

响应字段

​创建任务

​请求头

​请求参数

​内容规则

​响应

​查询任务

​请求头

​路径参数

​响应字段

创建任务

请求头

请求参数

内容规则

响应

查询任务

请求头

路径参数

响应字段