MiniMax H3 视频生成

MiniMax H3 系列走 MiniMax 原生异步接口(/api/v2),与火山 Seedance 形态(/api/v3)并存。两者都是「创建任务 → 轮询状态 → 取结果」,区别在路径、字段名和计费方式。

MiniMax 视频按秒计费(不同分辨率每秒单价不同),不是按 token。

模型与分辨率

H3 系列各变体支持的分辨率不同,实际可用档位以模型详情页定价为准:

模型支持分辨率说明
MiniMax-H3768P / 2K标准档,支持 2K
H3-Highspeed480P / 768P速度优先
H3-Lite480P / 768P成本优先
H3-Max480P / 768P质量优先,最短 5 秒

传入模型不支持的 resolution 会直接返回 400,不会提交到上游。

关键参数

参数类型必填说明
modelstring是模型调用名,从模型广场或模型列表获取
contentarray是输入内容,必须含至少一个非空 text 项
resolutionstring是768P / 2K 或 480P / 768P,取决于模型
durationinteger是输出时长(秒),4~15(H3-Max 最短 5)
ratiostring条件adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16;文生视频必填且不能 adaptive
callback_urlstring否任务终态回调地址(平台在任务完成时 POST 结果到该地址)
aigc_watermarkboolean否是否加水印,默认 false

content 元素

字段类型说明
typestringtext / image_url / video_url / audio_url
textstringtype=text 时必填
image_url.urlstring公网 URL
rolestringfirst_frame / last_frame / reference_image / reference_video / reference_audio

首尾帧(first_frame + last_frame)与参考生(reference_*)不能混用。

接口一览

操作方法路径
创建任务POST/api/v2/video_generation
查询任务GET/api/v2/query/video_generation/{task_id}
任务列表GET/api/v2/query/video_generation
取消/删除DELETE/api/v2/video_generation/{task_id}

任务状态:queued → running → succeeded / failed / cancelled。

文生视频

curl -X POST https://www.silvamux.com/api/v2/video_generation \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_CALL_NAME>",
    "content": [{"type": "text", "text": "一只金毛犬在海滩上奔跑,电影感"}],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

创建成功返回:

{"task_id": "462160194171102"}

查询任务

curl "https://www.silvamux.com/api/v2/query/video_generation/<TASK_ID>" \
  -H "Authorization: Bearer $SILVAMUX_API_KEY"

成功时响应包一层 task:

{
  "task": {
    "id": "462160194171102",
    "model": "<MODEL_CALL_NAME>",
    "status": "succeeded",
    "resolution": "768P",
    "duration": 5,
    "content": { "url": "https://..." },
    "usage": { "total_seconds": 5, "output_seconds": 5 }
  }
}
  • 产物地址在 task.content.url,有时效,成功后请尽快下载。
  • 计费秒数在 task.usage.total_seconds。

首帧图生 / 参考生

{
  "model": "<MODEL_CALL_NAME>",
  "content": [
    {"type": "text", "text": "镜头缓缓拉远,蒸汽增多"},
    {
      "type": "image_url",
      "image_url": {"url": "https://example.com/first.png"},
      "role": "first_frame"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "adaptive"
}

参考生(reference_image / reference_video / reference_audio)最多 9 图、3 视频、3 音频,音频不能单独出现。

取消任务

curl -X DELETE "https://www.silvamux.com/api/v2/video_generation/<TASK_ID>" \
  -H "Authorization: Bearer $SILVAMUX_API_KEY"

queued 状态的任务取消不收费用(预扣金额全额退回)。已进入 running 的任务上游不允许取消。

结果回调

传入 callback_url 后,任务进入终态时平台会向该地址 POST 结果,body 与查询接口同构({"task": {...}})。

用户的回调地址由平台代理接收后再转发,不需要实现 MiniMax 官方的 challenge 握手。

未传 callback_url 时可自行轮询查询接口,平台内部也有轮询兜底。

计费

按输出视频秒数计费,每秒单价因分辨率档位而异。例:

  • 768P 5 秒 × 单价
  • 2K 5 秒 × 单价(更高档位)

实际单价见模型详情页价格表或控制台定价页。

与火山 Seedance 的区别

项MiniMax H3火山 Seedance
创建路径/api/v2/video_generation/api/v3/contents/generations/tasks
创建响应{"task_id": ...}{"id": ...}
查询响应{"task": {...}}裸任务对象
产物字段task.content.urlcontent.video_url
计费按秒(分辨率分档)按 token

两套接口并存,任务彼此隔离:/api/v3 的任务列表不含 MiniMax 任务,反之亦然。