如何调用 MiniMax H3 视频生成 API(768P 与 2K,原生立体声音频)

在 RelayDance 上生成 MiniMax H3 视频: 向 https://relaydance.com/v1/video/generations 发送 POST,model 填 minimax-h3-768p 或 minimax-h3-2k,附上 prompt、4 到 15 秒的时长和宽高比,然后轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded,读取视频 url 即可。每条视频自带原生立体声音频,不额外收费; 768P 每秒 $0.10(见 relaydance.com/models)。

为什么选 MiniMax H3

MiniMax H3 的核心卖点是音画同源: 音轨与画面在同一次生成中产出,而不是事后拼接,所以脚步声、环境音、对白天然对齐画面。768P 档实际输出 1344x768、24 fps,2K 档主打最高画质。计费严格按生成秒数,6 秒的片子就只收 6 秒的钱。它与 Seedance 在 RelayDance 上互补: 同一端点、同一个密钥,各有所长。

设置 base URL 并认证

把 OpenAI 兼容客户端的 base URL 改为 https://relaydance.com/v1,请求头带 Authorization: Bearer YOUR_API_KEY。密钥在控制台创建(relaydance.com/console)。无需 MiniMax 账号、企业合同或 KYC; 按量付费,支持银行卡(Stripe)与 USDT。完整请求结构见 relaydance.com/docs。

文生视频: 第一条请求

最小请求 = 模型 + prompt + 时长 + 宽高比。文生视频必须给 ratio(16:9、9:16、1:1); 不填时 RelayDance 默认按 16:9 处理。adaptive 只有在附带参考图时才被上游接受。

curl -X POST https://relaydance.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-768p",
    "prompt": "夕阳下一只柯基在小浪上冲浪,电影感,海浪轻拍,远处有海鸥叫声",
    "duration": 6,
    "ratio": "16:9"
  }'

响应会返回 task_id。duration 接受 4 到 15 的整数; 也兼容 OpenAI 风格的字符串字段 seconds。

图生视频与参考图

在同一请求体里加 "image": "https://example.com/photo.jpg" 即可附带单张参考图; 此时 "ratio": "adaptive" 变为合法,输出跟随原图比例。多张参考图用 metadata.content[] 数组,每项形如 {"type": "image_url", "image_url": {"url": "..."}, "role": "reference_image"}。每次请求前 5 张参考图免费,之后每张约 $0.05。

轮询任务并读取结果

轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed; 成功后返回体里有视频 url。一般几分钟内完成(2K 比 768P 慢)。失败请求不计费: 预扣的额度会自动全额释放。

价格

MiniMax H3 按生成视频的秒数计费。提交任务时 RelayDance 先按最坏情况预扣,拿到真实输出时长后自动退还差额。实时价格见 relaydance.com/models。

参数速查

生成第一条 MiniMax H3 视频的步骤

1. 在 https://relaydance.com/console 创建 API 密钥。
2. POST /v1/video/generations,model 填 minimax-h3-768p,附 prompt、4 到 15 秒的 duration 和 ratio。
3. 可选: 加 image 做图生视频,或用 metadata.content[] 传多张参考图。
4. 轮询 GET /v1/video/generations/{task_id} 直到 succeeded 或 failed。
5. 从返回的 url 下载视频,立体声音轨已内嵌。

常见问题

音轨要额外收费吗? 不用。两档 MiniMax H3 都原生生成立体声音频,只按每秒视频价格收费。

一条视频最长多少秒? 4 到 15 秒。需要最长 30 秒的片子请用同一端点上的 Seedance 2.5(doubao-seedance-2-5-720p)。

请求失败会扣费吗? 不会。按 relaydance.com/models 的官方说明,失败或报错的请求一律不计费。

选 768P 还是 2K? 768P 实际输出 1344x768、24 fps,$0.10/秒,性价比之选; 2K 是画质之选,$0.1625/秒,生成更慢。

需要 MiniMax 账号吗? 不需要。一个 RelayDance 密钥即可调用 MiniMax H3、Seedance 及目录里的全部模型。