MiniMax H3 视频生成（768p / 1440p）

通过 bubu12key 视频 API，可以提交文字描述，也可以加入图片、视频和音频作为参考。接口采用异步任务：提交后保存任务 ID，定时查询状态，完成后从返回的地址下载视频。本文分别说明 768p 与新增 1440p 系列的参数。

minimax-h3 是 API Key 使用的分组。请求中的 model 必须填写完整模型 ID；分组名称和 MiniMax-H3-933-1440p 系列名称都不能直接作为模型 ID。

模型档位与开放情况

768p H3 按秒售价

Minimax-H3-768p-933-10s-15s 使用 minimax-h3 分组，标准售价为 0.10 元／秒，支持 10–15 秒整数，省略时长时默认 10 秒。此价格为 2026-09-17 核对的标准分组客户售价。

10 秒：0.10 × 10 = 1.00 元
12 秒：0.10 × 12 = 1.20 元
15 秒：0.10 × 15 = 1.50 元

768p 按秒示例见下方调用说明；与 Seedance 按秒模型的价格对照见视频按秒计费。固定 -10s / -15s 档仍按次计费。

1440p H3 客户售价

bubu12key 使用 1 元 = 1 美元显示额度的站内计价口径：若界面显示美元符号，1.50 元对应显示额度 1.50，不再按外汇汇率换算。以上为标准售价；账户专属优惠及最终结算以控制台为准。

固定档不需要传 seconds 或 duration，选择 -10s / -15s 就确定了时长，整次价格无需再乘秒数。可变档可传 seconds 或 duration，取 10–15 的整数，省略时默认 10 秒；建议显式使用 seconds。两者同时传入时必须一致。

两个系列的可变档后缀不同：768p 是 -10s-15s，1440p 是 -10-15s，请完整复制模型 ID。本文 1440p 三档共用下方多参考参数。

鉴权与接口地址

API 根地址为 https://bubu12key.top。提交和查询使用 Bearer Key；提交请求体使用 JSON。

Authorization: Bearer sk-你的APIKey
Content-Type: application/json

请将 Key 保存在服务端或环境变量中。仅传 X-Api-Key 不能替代视频提交和查询所需的 Authorization。

所有档位使用同一个创建路径，通过 JSON 的 model 区分。不要在 /v1/videos/generations 后追加模型名。任务列表 GET /v1/videos 和删除任务 DELETE /v1/videos/{task_id} 当前未开放，请自行保存任务 ID。

768p 按秒调用：生成 12 秒视频

先在终端设置自己的 API Key。以下请求使用 Minimax-H3-768p-933-10s-15s 生成 12 秒视频，标准费用为 0.10 × 12 = 1.20 元：

export BUBU12KEY_API_KEY="sk-你的APIKey"
curl --fail-with-body -sS --max-time 180 https://bubu12key.top/v1/videos \
  -H "Authorization: Bearer $BUBU12KEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Minimax-H3-768p-933-10s-15s",
    "prompt": "清晨薄雾中的湖面，一艘木船缓缓驶过，镜头平稳跟随，水面倒影清晰",
    "seconds": 12,
    "aspect_ratio": "16:9"
  }'

seconds 取 10–15 的整数，省略默认 10 秒；duration 是别名，建议只传一个时长字段。不要填小数、带单位的文字或超出范围的值。768p 分辨率由模型决定，无需传 resolution / size。

提交后保存 id（为空时读取 task_id），再查询 GET /v1/videos/{task_id}。状态与下载方式和固定档相同，详见轮询下载示例。

快速开始：1440p 固定 10 秒

以下为 Bash 示例，需要 curl 和 jq。先设置自己的 Key；目标模型需要已在该 Key 的模型列表中开放。

BASE="https://bubu12key.top"
KEY="sk-你的APIKey"
MODEL="MiniMax-H3-933-1440p-10s"

# 确认 Key 已开放目标模型
MODELS=$(curl --fail-with-body -sS --max-time 30 "$BASE/v1/models" \
  -H "Authorization: Bearer $KEY") || exit 1
printf '%s' "$MODELS" | jq -e --arg model "$MODEL" \
  '.data | any(.id == $model)' >/dev/null || {
    echo "当前 Key 尚未开放目标模型" >&2
    exit 1
  }

# 固定档无需时长、分辨率参数
BODY=$(jq -n --arg model "$MODEL" '{
  model: $model,
  prompt: "清晨薄雾中的湖面，一艘木船缓缓驶过，镜头平稳跟随，水面倒影清晰",
  aspect_ratio: "16:9"
}')
R=$(curl --fail-with-body -sS --max-time 180 "$BASE/v1/videos" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  --data-binary "$BODY") || exit 1
ID=$(printf '%s' "$R" | jq -er '.id // .task_id') || exit 1
echo "请保存任务 ID：$ID"

生成 15 秒，将模型改为 MiniMax-H3-933-1440p-15s；使用 768p 固定 10 秒，将模型改为 Minimax-H3-768p-933-10s。拿到 ID 后接下方轮询下载示例。

完整请求参数

两个系列的能力区别

各类上限与总上限需要同时满足。例如 9 张图＋3 段视频＋3 段音频适用于 1440p；768p 使用 9 张图＋2 段视频＋1 段音频时恰好达到 12 个。纯文字生成可完全省略素材字段。

画幅和输出尺寸

以上八种比例均适用于本文两个 H3 系列。不要把像素尺寸填入 aspect_ratio，也不要假定省略后一定得到横屏。

参考素材与调用示例

素材 URL 应能从公网直接读取文件内容，不应指向需要登录的网页、本地路径或分享页面。临时签名地址需要在生成期间保持有效。参考视频和音频的 15 秒限制针对每个输入片段，输出时长仍由模型及其时长字段决定。

索引模式：图片＋视频＋音频

各类素材独立从 1 开始编号，对应其数组顺序：第一张图是 @图片1，第一段视频是 @视频1，第一段音频是 @音频1。上传两个图片后才能引用 @图片2。这些标签写在提示词中，没有额外的编号字段。

下例生成 12 秒 1440p 视频。把素材地址替换为自己的真实文件后，作为 JSON 提交到 POST /v1/videos。

{
  "model": "MiniMax-H3-933-1440p-10-15s",
  "prompt": "@图片1 中的人物是主角，@图片2 作为海边环境参考；采用 @视频1 的平稳跟拍方式，声音氛围参考 @音频1。主角沿木栈道慢步，远处海浪轻轻拍岸，傍晚暖色光线，人物外观始终一致。",
  "seconds": 12,
  "aspect_ratio": "16:9",
  "images": [
    "https://example.com/character.jpg",
    "https://example.com/seaside.jpg"
  ],
  "metadata": {
    "video_urls": ["https://example.com/camera.mp4"],
    "audio_urls": ["https://example.com/ambience.mp3"]
  }
}

无索引模式：1440p 图片参考

1440p 系列可以上传参考素材而不写任何 @ 标签，让模型结合描述选择参考信息，无需额外的模式参数。希望精确指定素材用途时使用索引模式。

{
  "model": "MiniMax-H3-933-1440p-15s",
  "prompt": "保持参考图片中的陶瓷杯造型和纹理，杯子置于木桌上，镜头缓慢环绕，柔和侧光突出釉面细节。",
  "aspect_ratio": "9:16",
  "images": ["https://example.com/cup.jpg"]
}

768p 固定档与字段别名

768p 可用相同的标准素材字段，也可使用 metadata.videos / metadata.audios。下例使用别名，每类只写一个字段。

{
  "model": "Minimax-H3-768p-933-10s",
  "prompt": "@图片1 保持建筑外观，参考 @视频1 的镜头移动和 @音频1 的环境氛围，雨后街道，倒影自然。",
  "aspect_ratio": "16:9",
  "images": ["https://example.com/building.jpg"],
  "metadata": {
    "videos": ["https://example.com/street.mp4"],
    "audios": ["https://example.com/rain.mp3"]
  }
}

响应字段与状态

提交成功表示任务已受理，通常返回 HTTP 200 和任务 ID，不表示视频已生成。以下均为结构示例；可选字段可能省略。

{
  "id": "task_example_1440p",
  "task_id": "task_example_1440p",
  "object": "video",
  "model": "MiniMax-H3-933-1440p-10-15s",
  "status": "queued",
  "progress": 0,
  "created_at": 1789344000,
  "seconds": "12",
  "size": "2560x1440"
}

完成响应示例：

{
  "id": "task_example_1440p",
  "object": "video",
  "model": "MiniMax-H3-933-1440p-10-15s",
  "status": "completed",
  "progress": 100,
  "created_at": 1789344000,
  "completed_at": 1789344300,
  "seconds": "12",
  "size": "2560x1440",
  "metadata": {
    "url": "https://videos.bubu12key.top/videos/2026/09/14/task_example_1440p.mp4"
  }
}

轮询并下载完整示例

接快速开始中的 BASE、KEY 和 ID。建议每 5–10 秒查询一次，示例每 10 秒查询、最多查询 180 次；单次请求另有超时限制。达到客户端等待上限后保存任务 ID，稍后继续查，不应直接把任务判为失败或自动重复提交。

for i in $(seq 1 180); do
  R=$(curl --fail-with-body -sS --max-time 60 "$BASE/v1/videos/$ID" \
    -H "Authorization: Bearer $KEY") || {
      echo "查询失败，请保留任务 ID 后重试查询：$ID" >&2
      exit 1
    }
  ST=$(printf '%s' "$R" | jq -er '.status') || exit 1
  echo "[$i] status=$ST"
  case "$ST" in
    completed|succeeded)
      URL=$(printf '%s' "$R" | jq -er \
        '[.metadata.url, .result_url, .url] | map(select(type == "string" and length > 0)) | first') || {
          echo "已完成但未取得视频地址，请记录任务 ID 联系支持：$ID" >&2
          exit 1
        }
      curl --fail --location --retry 2 --max-time 900 "$URL" -o video.mp4 || exit 1
      echo "已保存 video.mp4"
      exit 0
      ;;
    failed)
      printf '%s' "$R" | jq '.error // .fail_reason // "生成失败"'
      exit 1
      ;;
    queued|in_progress|processing) ;;
    *) echo "遇到未知状态，保留任务 ID 并检查响应：$ID" >&2; exit 1 ;;
  esac
  sleep 10
done
echo "达到等待上限，任务仍可继续查询：$ID" >&2
exit 1

POST 创建请求超时并不能证明任务未受理。排查前不要启用自动重提，否则可能生成多个任务并重复计费。查询失败时重试已有任务的 GET 请求即可。

下载、播放与保存

# 按任务 ID 下载已完成视频
curl --fail --location --max-time 900 \
  "https://bubu12key.top/v1/videos/$ID/content" -o video.mp4

优先使用本次查询实际返回的地址，不要自己拼接域名、日期目录或文件名。/content 返回视频二进制流；失败时可能返回 JSON，保存前必须检查 HTTP 状态。该下载路由仅开放 GET，不应使用 HEAD 探测。需要分段读取时请直接向返回的视频直链发出 Range 请求。

bubu12key 视频地址为临时保存服务，保存期限以当前服务策略为准，不提供永久存储承诺。完成后请及时下载到自己的存储；已清理的文件无法保证恢复。持有免鉴权下载链接的人可以访问文件，请按需分发链接。

错误处理与排查

区分 HTTP 请求失败与已受理任务的生成失败：HTTP 非 2xx 时先检查响应体；HTTP 200 的查询仍可能返回 status: failed。错误字段示意：

{
  "error": {
    "code": "invalid_request",
    "message": "请求参数不符合要求"
  }
}

反馈时提供模型 ID、任务 ID、发生时间、HTTP 状态以及响应头中的请求 ID（如 X-Oneapi-Request-Id）。不要提交完整 API Key。