MiniMax-H3 视频生成

通过 APIMaster 的 OpenAI 兼容视频接口调用 MiniMax-H3。该模型支持文本生成视频，任务为异步执行。

Base URL：https://apimaster.ai/v1 即 https://apimaster.ai/v1。MiniMax-H3 创建任务使用 POST https://apimaster.ai/v1/video/generations。

接口兼容与参数校验

POST https://apimaster.ai/v1/video/generations 和 POST https://apimaster.ai/v1/videos/generations 均可使用；同一模型的请求参数与计费规则一致，创建响应沿用各入口原有格式。无需因本次更新修改现有调用路径。

MiniMax-H3 保留本页单数入口示例，size 与 resolution 等价，ratio 与 aspect_ratio 等价。不支持的规格或互相冲突的别名返回 HTTP 400；不会静默切换到更高分辨率。建议显式填写分辨率、比例和时长。

创建视频任务

POST https://apimaster.ai/v1/video/generations

请求头：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

字段	类型	必填	说明
model	string	是	固定为 MiniMax-H3
prompt	string	按格式	视频内容描述
duration	integer	否	视频时长，4–15 秒，默认 4 秒
size	string	否	768P 或 2K，默认 768P
ratio	string	否	画面比例，默认 16:9
metadata	object	否	额外参数；显式 content 优先于 prompt/images，顶层 V2 字段优先于同名 metadata 字段

curl -s "https://apimaster.ai/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "日出时平静的海面，轻柔的海浪，电影感宽镜头",
    "duration": 4,
    "size": "768P",
    "ratio": "16:9"
  }'

响应会立即返回任务 ID：

{
  "id": "task_xxxxxxxx",
  "task_id": "task_xxxxxxxx",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "queued",
  "progress": 0,
  "created_at": 1786436206
}

查询任务状态

GET https://apimaster.ai/v1/videos/{task_id}

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

任务状态包括 queued、in_progress、completed 和 failed。完成后响应包含视频地址：

{
  "id": "task_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "url": "https://apimaster.ai/v1/videos/task_xxxxxxxx/content"
}

建议提交后等待 10–20 秒，再每 3–5 秒轮询一次。

下载视频

GET https://apimaster.ai/v1/videos/{task_id}/content

curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o output.mp4

视频地址可能有有效期，任务完成后请及时下载并保存 MP4 文件。

参数限制与错误

• model 必须为 MiniMax-H3。
• duration 仅支持 4–15 秒。
• size 支持 768P 和 2K。
• 未启用或余额不足的渠道会返回无可用渠道或上游余额错误；请先确认账户余额和渠道状态。
• 任务失败时，查询响应会包含失败状态和原因，不应继续下载视频。

参考图生成视频（r2v）

向上述 APIMaster 入口提交官方 V2 的 content 数组即可。数组必须包含非空 text 项；提供 content 后不再要求顶层 prompt。reference_image 用于参考主体或风格，不锁定首帧。旧格式 images 的前两张图分别映射首帧、尾帧，请勿与参考素材角色混用。

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
    {"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
  ],
  "resolution": "768P",
  "duration": 4,
  "ratio": "16:9"
}

现有入口仍为 POST https://apimaster.ai/v1/video/generations；/v1/v2/video_generation 不是有效路径。本接口兼容 V2 请求体，但创建响应和查询接口沿用本页的 APIMaster 任务格式。顶层 content 优先于 metadata.content；显式内容不会与 images 合并。