MiniMax-H3 视频生成怎么用？物理动态提示词与 API 调用教程

MiniMax-H3 走 POST /v1/videos 异步生成视频。

模型 ID: MiniMax-H3
端点: POST /v1/videos
查询: GET /v1/videos/{task_id}
下载: GET /v1/videos/{task_id}/content
适配: curl / Python requests
计费: 按次

参数	值
模型 ID	`MiniMax-H3`
类型	视频
调用端点	`POST /v1/videos`，轮询 `GET /v1/videos/{task_id}`
兼容协议	OpenAI Videos API（multipart 表单）
推荐客户端	curl、Python requests
计费方式	按次，实时价格见定价页

MiniMax-H3 适合做什么，不适合做什么？

适合雨水、碰撞、人体动作等需要物理真实感的视频。

MiniMax-H3 以真实世界物理运动规律模拟见长，雨水飞溅、汽车漂移、复杂的人体肢体交互都能呈现可信的惯性与重力细节。

适合的场景：

水流、烟雾、爆炸等流体与粒子镜头
汽车、运动等高速动作场景
人物肢体交互和表情变化

不太适合：只需要静态画面或简单转场的素材，生图模型成本更低。

MiniMax-H3 的 Base URL 和 API Key 怎么获取？

Base URL 填 deepclub.net/v1，Key 在控制台创建。

登录深云 DeepClub，进入控制台的 API 令牌 页面。
点击 添加令牌，复制生成的 sk- 开头密钥。
在客户端或代码中填写以下三项：

Base URL: https://deepclub.net/v1
API Key:  sk-你的DeepClub密钥
Model:    MiniMax-H3

怎么用 API 生成 MiniMax-H3 视频？

先 POST /v1/videos 提交任务，再轮询状态，完成后下载。

第一步，用 multipart 表单提交任务，字段为 model、prompt、seconds：

curl https://deepclub.net/v1/videos \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY" \
  -F model=MiniMax-H3 \
  -F prompt="一辆赛车在湿滑弯道漂移，水花向外飞溅" \
  -F seconds=5

返回 JSON 中的 id 就是任务 ID，初始 status 为 queued。

第二步，轮询任务状态，直到 status 变为 completed 或 failed：

curl https://deepclub.net/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY"

第三步，任务完成后下载视频文件：

curl -L https://deepclub.net/v1/videos/$TASK_ID/content \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY" \
  -o output.mp4

seconds 是视频时长（秒），平台对时长设有上限，超出会返回 400。

用 Python 怎么轮询 MiniMax-H3 视频任务？

用 requests 提交表单，每隔数秒查询一次状态。

import time
import requests

BASE = "https://deepclub.net/v1"
headers = {"Authorization": "Bearer sk-你的DeepClub密钥"}

resp = requests.post(
    f"{BASE}/videos",
    headers=headers,
    files={
        "model": (None, "MiniMax-H3"),
        "prompt": (None, "一辆赛车在湿滑弯道漂移，水花向外飞溅"),
        "seconds": (None, "5"),
    },
)
resp.raise_for_status()
task_id = resp.json()["id"]

while True:
    task = requests.get(f"{BASE}/videos/{task_id}", headers=headers).json()
    if task["status"] in ("completed", "failed"):
        break
    time.sleep(10)

if task["status"] == "completed":
    video = requests.get(f"{BASE}/videos/{task_id}/content", headers=headers)
    with open("output.mp4", "wb") as f:
        f.write(video.content)
else:
    print(task.get("error"))

MiniMax-H3 怎么写提示词让物理效果更真实？

写清材质、受力和运动方向，少用抽象形容词。

与其写“震撼的水花”，不如写“赛车左后轮压过积水，水花呈扇形向右后方飞溅，水滴在逆光下闪亮”。具体的材质和方向能帮助模型生成正确的运动轨迹。

人物动作建议描述起始姿态和结束姿态，例如“从蹲下到起跳，双臂向上摆动”。

MiniMax-H3 API 怎么计费？

按次计费，每成功生成一次计一次。

实时价格见定价页。

计费单位：按次，价格可能调整，以定价页实时显示为准。
用量明细：在控制台 使用日志 中按请求查看消耗。
充值方式：支持 PayPal、Visa/Mastercard、支付宝。

调用 MiniMax-H3 报 401 怎么办？

401 表示密钥无效或缺失，先检查 Key 是否完整。

确认 API Key 前后没有空格或换行，且令牌未被禁用、未过期。
请求头格式为 Authorization: Bearer sk-...。
如果返回 404，检查 Base URL 是否为 https://deepclub.net/v1，模型名是否为 MiniMax-H3。

用 MiniMax-H3 时请求内容会被存储或用于训练吗？

不会，深云 DeepClub 实行零留存（ZDR）政策。

深云 DeepClub 实行 Zero Data Retention (ZDR) 零留存政策：请求的输入和输出内容不做持久化存储，也不会用于模型训练，详见隐私政策。

使用 MiniMax-H3 还有哪些常见问题？

以下问答汇总了调用时最常见的问题。

调用 MiniMax-H3 返回 401 Unauthorized 怎么办？

401 表示密钥无效或缺失，先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。

MiniMax-H3 用哪个接口生成视频？

先用 POST /v1/videos 以 multipart 表单提交 model、prompt、seconds，再轮询 GET /v1/videos/{task_id}，完成后从 GET /v1/videos/{task_id}/content 下载。

MiniMax-H3 API 怎么计费？

按次计费，每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/MiniMax-H3。

MiniMax-H3 怎么写提示词让物理效果更真实？

写清材质、受力和运动方向，少用抽象形容词。

常见问题

调用 MiniMax-H3 返回 401 Unauthorized 怎么办？: 401 表示密钥无效或缺失，先检查 API Key 是否复制完整、前后没有空格。请求头格式为 Authorization: Bearer sk-...。
MiniMax-H3 用哪个接口生成视频？: 先用 POST /v1/videos 以 multipart 表单提交 model、prompt、seconds，再轮询 GET /v1/videos/{task_id}，完成后从 GET /v1/videos/{task_id}/content 下载。
MiniMax-H3 API 怎么计费？: 按次计费，每成功生成一次计一次。实时价格见 https://deepclub.net/pricing/MiniMax-H3。
MiniMax-H3 怎么写提示词让物理效果更真实？: 写清材质、受力和运动方向，少用抽象形容词。

更新于 2026-10-31