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

请求头：

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	否	额外元数据；模型、提示词和上述显式参数以请求字段为准

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、running、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。
• 未启用或余额不足的渠道会返回无可用渠道或上游余额错误；请先确认账户余额和渠道状态。
• 任务失败时，查询响应会包含失败状态和原因，不应继续下载视频。