MiniMax视频

MiniMax H3 参考素材生成视频 API

Name: MiniMax H3 API
Brand: MiniMax
SKU: minimax/h3
Availability: InStock

由 MiniMax 提供参考素材生成视频与 MiniMax H3。海螺 H3——动作表现力和物理效果出色，最高 2K。

minimax/h3/reference-to-video

起价最高 −29%

$0.057/s$0.08

视频按秒计费 · 768P

使用 Max：起价 $0.055/s →运行正常100% 正常运行时间（30 天）中位数 3m 37s

用 MiniMax H3 创作获取 API 密钥

API 文档 →对比模型 →

试用 MiniMax H3 参考素材生成视频

提示词*

输入 @ 即可引用参考素材图像、视频或音频0/5000

参考图像

最多使用 5 张图像指定角色、产品、风格或场景。在提示词中使用 @Image1、@Image2…来引用。

参考视频

最多 3 段MP4/MOV，用于指定动作、镜头运动或特效（每段 2–15 秒, 总计 15 秒, 每个 ≤ 50 MB）。使用 @Video1、@Video2…来引用。参考视频的秒数会像输出视频一样计费。

参考音频

最多 3 段MP3/WAV，用于指定人声、音乐或音效（每段 2–15 秒, 总计 15 秒, 每个 ≤ 15 MB）。使用 @Audio1、@Audio2…来引用。至少需要一张参考图像或一段参考视频。

宽高比

输出画面比例。

分辨率

输出分辨率。分辨率越高，每秒价格越高。

时长

生成视频片段时长（5–15 秒）。按秒计费。

预计费用…

使用 Google 或电子邮箱免费创建账户，只为你生成的内容付费。

你的视频会显示在这里

输入提示词，选择设置，然后点击“运行”。仅成功生成的结果会收费。

还可查看：MiniMax H3 文生视频 · MiniMax H3 图生视频

查看 MiniMax H3 示例和提示词

MiniMax H3 参考素材生成视频 API

POST/api/v1/run/minimax/h3/reference-to-video

提交异步任务并返回 202 和生成任务 ID。请轮询 GET /api/v1/generations/{id} 或传入 webhook_url。参见任务生命周期。

输入参数

名称	类型	说明	影响价格
`prompt`必填	string	描述镜头，包括主体、动作、镜头运动、光线和风格。	否
`reference_image_urls`	string[] (URLs)	最多使用 5 张图像指定角色、产品、风格或场景。在提示词中使用 @Image1、@Image2…来引用。最多数量：5	否
`reference_video_urls`	string[] (video URLs)	最多 3 段MP4/MOV，用于指定动作、镜头运动或特效（每段 2–15 秒, 总计 15 秒, 每个 ≤ 50 MB）。使用 @Video1、@Video2…来引用。参考视频的秒数会像输出视频一样计费。最多数量：3	是
`reference_audio_urls`	string[] (audio URLs)	最多 3 段MP3/WAV，用于指定人声、音乐或音效（每段 2–15 秒, 总计 15 秒, 每个 ≤ 15 MB）。使用 @Audio1、@Audio2…来引用。至少需要一张参考图像或一段参考视频。最多数量：3	否
`aspect_ratio`	string (enum)	输出画面比例。可选值：16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 默认值：16:9	是
`resolution`	string (enum)	输出分辨率。分辨率越高，每秒价格越高。可选值：768P · 2K 默认值：768P	是
`duration`	integer	生成视频片段时长（5–15 秒）。按秒计费。范围：5–15s 默认值：6	是
`seed`	integer	使用相同的 seed 和设置即可复现结果。留空则随机生成。	否
`webhook_url`	string (URL)	可选。生成完成后，我们会在此地址 POST 结果，并使用你的 Webhook 密钥进行签名。Webhooks	否

请求

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "@Image1 中的吉祥物在 @Image2 中的店面前跳舞，动作参考 @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/minimax/h3/reference-to-video", headers=headers, json={
    "prompt": "@Image1 中的吉祥物在 @Image2 中的店面前跳舞，动作参考 @Video1",
    "reference_image_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.jpg",
        "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/minimax/h3/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "@Image1 中的吉祥物在 @Image2 中的店面前跳舞，动作参考 @Video1",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg",
    "https://cdn.cheapergen.com/samples/reference-2.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp4"
  ],
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

响应

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3",
  "endpoint": "minimax/h3/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "@Image1 中的吉祥物在 @Image2 中的店面前跳舞，动作参考 @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3",
  "endpoint": "minimax/h3/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "@Image1 中的吉祥物在 @Image2 中的店面前跳舞，动作参考 @Video1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg",
      "https://cdn.cheapergen.com/samples/reference-2.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

MiniMax H3 定价

按视频按秒计费按量付费，无需订阅。生成失败会自动退款。

档位	官方价格	CheaperGen	可节省
768P 每秒	~~$0.08~~/s	$0.057/s 订阅月度套餐后： Pro $0.0557Max $0.0544	−29%
2K 每秒	~~$0.13~~/s	$0.1068/s 订阅月度套餐后： Pro $0.1033Max $0.0998	−18%