API
CLUB

MiniMax 视频

异步视频任务。提交后得到任务 ID，轮询状态，完成后下载作品。

查看价格获取 API 密钥

可用模型

MiniMax-H3满血

选择模型，下方示例和参数会切换为该模型。

MiniMax-H3

异步视频任务 · MiniMax · POST /v1/tasks/hailuo

请求示例
curl -X POST 'https://code.exgravity.ai/v1/tasks/hailuo' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "MiniMax-H3",
  "prompt": "一只橘猫坐在窗边，柔和的午后阳光，电影质感",
  "duration": 5,
  "resolution": "768P",
  "metadata": {
    "ratio": "16:9"
  }
}'

请求参数

字段说明
duration视频秒数，4–15 秒。
resolution768P / 2K
metadata.ratio16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9；有参考画面时可使用 adaptive。
metadata.content文字、图片、视频和音频的多模态内容数组。

参考素材

参考视频使用 video_url 与 reference_video，参考音频使用 audio_url 与 reference_audio。

带参考素材的请求
curl -X POST 'https://code.exgravity.ai/v1/tasks/hailuo' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "MiniMax-H3",
  "prompt": "一只橘猫坐在窗边，柔和的午后阳光，电影质感",
  "duration": 5,
  "resolution": "768P",
  "metadata": {
    "ratio": "16:9",
    "content": [
      {
        "type": "text",
        "text": "一只橘猫坐在窗边，柔和的午后阳光，电影质感"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://your-domain.example/reference.png"
        },
        "role": "reference_image"
      }
    ]
  }
}'

提交结果与任务

提交成功后读取 data.task_id，再查询任务状态并获取作品。

提交响应
{
  "code": "success",
  "data": {
    "task_id": "task_xxx"
  }
}

保存 data.task_id，然后按「异步任务与作品」轮询状态并下载作品。