Euno AI

简体中文

English

简体中文

English

Appearance

MiniMax-H3 视频生成 ​

MiniMax-H3（MiniMax-H3）是 MiniMax 海螺系列视频生成模型，支持文生视频、图生视频（首帧）与视频参考等用法，默认输出 768P，可通过参数切换 2K。调用走统一 POST /v1/videos 接口，返回 OpenAI Video 风格（id / status / metadata.url），与其它视频模型共享同一套任务轮询机制。

计费方式

按**实际生成时长（秒）**计费，分辨率档位（768P / 2K）单价不同。具体单价与计费表达式以控制台「模型广场」对应模型卡片展示为准（文档不展示实时价格）。

端点 ​

  • 创建任务：POST $URL/v1/videos
  • 查询任务：GET $URL/v1/videos/{task_id}

兼容入口

同时支持 OpenAI Sora 风格别名：POST $URL/v1/video/generations、GET $URL/v1/video/generations/{task_id}，二者等价。

支持模型 ​

模型名称定位支持分辨率
MiniMax-H3视频生成，默认 768P，可切换 2K768P / 2K

分辨率档位通过 metadata.resolution 指定（见下方「主要参数」）。

主要参数 ​

参数类型必填说明
modelstring是MiniMax-H3
promptstring是视频内容描述，建议包含主体、动作、场景、镜头
image / imagesstring / array否参考图片 URL（单张或数组，作为首帧生成图生视频）
input_referencestring否参考视频 URL，用于视频参考生成
secondsstring否输出时长（秒），如 "5"、"10"，默认 5 秒
metadata.resolutionstring否分辨率档位：768P（默认）/ 2K
metadata.ratiostring否画面比例，默认 16:9，如 9:16、1:1
metadata.durationnumber否覆盖输出时长（秒）
metadata.aigc_watermarkboolean否是否添加 AIGC 内容水印
metadata.callback_urlstring否任务完成回调地址（上游主动通知）

参考素材说明

支持直接传公网可访问的图片 / 视频 URL（上游服务端会自行拉取，内网或本地地址会失败）。

请求示例 ​

文生视频 ​

bash
# 1. 创建视频任务（768P，5 秒）
curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "一只海豚跃出海面，夕阳下溅起金色水花，慢镜头，电影质感",
    "seconds": "5"
  }'

# 2. 查询任务状态（替换 {task_id} 为上一步返回的 id）
curl $URL/v1/videos/{task_id} \
  -H "Authorization: Bearer $YOUR_API_KEY"
python
import time
import requests

url = "$URL/v1/videos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "model": "MiniMax-H3",
    "prompt": "A dolphin leaping out of the sea at sunset, golden splashes, slow motion, cinematic",
    "seconds": "5",
}

task = requests.post(url, json=payload, headers=headers).json()
task_id = task["id"]

while True:
    result = requests.get(f"{url}/{task_id}", headers=headers).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(8)

print(result)

图生视频（首帧） ​

bash
curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "让画面中的机器人站起来向镜头挥手",
    "image": "https://example.com/ref.png",
    "seconds": "5"
  }'

视频参考 ​

bash
curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "将视频中的场景转换为夜晚霓虹灯光效",
    "input_reference": "https://example.com/clip.mp4",
    "seconds": "5"
  }'

切换 2K 分辨率 ​

通过 metadata.resolution 指定分辨率档位：

bash
curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "无人机航拍雪山云海，日出金光，震撼全景",
    "seconds": "5",
    "metadata": {
      "resolution": "2K"
    }
  }'

响应字段 ​

创建任务与查询任务返回同一结构（OpenAI Video 风格）：

字段类型说明
idstring任务 ID
statusstring任务状态（见下方状态说明）
metadata.urlstring生成完成后的视频地址（仅 completed 时返回）
progressinteger生成进度，0~100
completed_atinteger完成时间戳（秒，仅 completed 时返回）
error.messagestring失败原因（仅 failed 时返回）

任务状态 ​

状态含义处理建议
queued排队中继续轮询
in_progress生成中继续轮询
completed生成成功从 metadata.url 获取视频地址，请尽快下载保存
failed生成失败查看 error.message

建议轮询间隔 5~10 秒

任务完成后请尽快下载转存：视频地址有时效性，过期后无法再访问。

响应示例 ​

json
{
  "id": "task_xxxxxxxx",
  "status": "in_progress",
  "progress": 50
}

完成后：

json
{
  "id": "task_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://cdn.example.com/.../result.mp4"
  },
  "completed_at": 1786431715
}

常见问题 ​

Q: 支持哪些参考素材？

支持参考图片（首帧图生视频）与参考视频（视频参考生成），传入公网可访问的 URL 即可（见上文 image / images / input_reference）。

Q: 任务大概多久完成？

与时长和分辨率相关，768P 5 秒通常在 1~3 分钟内完成，2K 会更久。请通过轮询查询接口获取最终状态。

Q: 生成的视频链接会过期吗？

会。视频地址有时效性，生成完成后请尽快下载转存到自己的存储。

Q: 支持素材库吗？

不提供独立素材库，请使用公网可访问的图片/视频 URL 作为参考素材。

© 2026 Euno AI 版权所有