XXT基于 MiniMax H3
EN登录

用 Claude Code、Codex 生成视频：在终端里调 MiniMax H3

把一句指向我们 SKILL.md 的话交给你的 Agent。它会装好 h3 命令行（一个 Python 文件），发来一个授权链接让你点确认，然后写提示词、告诉你这条要冻结多少积分、提交、等待、下载成片。Claude Code、Codex 和任何能跑命令行的 Agent 都能用。

要准备什么

  • 一个 XXT 账号：用邮箱登录就会自动创建，新账号送 500 积分。
  • 一个能跑命令行的 Agent：Claude Code、Codex，或别的本地 Agent。
  • Python 3.9 或更新。macOS 自带的 Python 就行；Windows 用 python h3.py 运行。
  • 可选：ffmpeg，要让 Agent 把几段拼成一条时用。

第一步：把一句话交给 Agent

把下面这句话贴给你的 Agent，用什么语言贴，它就用什么语言回你：

请阅读 https://minimax.xxt.ai/SKILL.md，按里面的说明安装 h3 命令行并运行 h3 login，把它给出的授权链接发给我。我授权后，你帮我出视频。

它读的 SKILL.md 是写给 Agent 的（英文）：选哪种模式、提示词怎么写、积分怎么算、每个报错怎么处理。你自己不用读。

第二步：点开授权链接

Agent 先装命令行。它是一个只用标准库的 Python 文件：

mkdir -p ~/.local/bin
curl -fsSL https://minimax.xxt.ai/h3.py -o ~/.local/bin/h3 && chmod +x ~/.local/bin/h3
h3 login --no-wait

h3 login 会给出一个链接和一个短码，Agent 把它们发给你。打开链接，需要的话先登录（Google 账号或邮箱验证码），核对短码一致，点「授权」。Agent 就拿到了你账号下它自己的 API Key；你不用复制 Key，也随时可以在「API Key」页吊销它。

第三步：让它出片

用大白话说你想要什么，有图片或人声就一起给它。Agent 会选模式、按我们的提示词标准用英文写提示词，提交前告诉你这条要冻结多少积分。它的说明里要求：一次超过 1,000 积分、或者要连着提交一批时，先问你。

h3 submit --mode i2v --first-frame shot1.png --aspect 9:16 --seconds 6 \
  --prompt "A medium shot frames the girl standing by the river at dusk. She slowly turns her head toward the camera and smiles softly as the evening breeze lifts her hair. The camera holds a static shot." \
  --wait --out ./out

每个命令都输出 JSON，本地文件自动上传。出完以后，Agent 会把每个下载好的文件的完整路径给你。它还会用到：h3 jobs（最近的任务）、h3 wait <任务 id>、h3 pull <任务 id>、h3 cancel <任务 id>（冻结的积分全退）、h3 me（余额）、h3 ledger（积分流水）。

成片、歌曲和上传的素材在任务结束后保存 8 小时，之后自动删除，请及时下载。

把说明装在本机

h3 skill install 把 SKILL.md 和几份参考文件存到 ~/.claude/skills/h3-video/，Claude Code 会把它当成一个技能。用别的 Agent 就加 --host：codex（也就是通用目录 ~/.agents/skills，Cursor、Gemini CLI、OpenCode、GitHub Copilot 也都读）、cursor、gemini、opencode、copilot，或者 all（Claude Code 加通用目录）；别的位置用 --dir。有新版本时，命令行会自己更新，存好的文件也跟着更新。

h3 skill install                 # Claude Code
h3 skill install --host codex    # Codex、Cursor、Gemini CLI 等

Agent 能做什么

  • 文生视频：只用一段描述。
  • 首帧 / 首尾帧生视频：让一张图动起来。
  • 自由镜头：不用首帧，选存好的角色或给几张照片，镜头之间脸不变，见人物一致性。
  • 对口型：照片里的人照着一段人声唱、说，见对口型。
  • 带货视频：一个角色当主播介绍商品；长视频分段做，再用 h3 concat 拼起来。
  • 出歌：给歌词和曲风，一次出 2 首。

视频 4–60 秒，竖屏 9:16、横屏 16:9 或方形 1:1，768P 或 1080P。

为什么用命令行，不用 MCP 服务

  • 不用在后台跑任何服务：一个文件，只用标准库。
  • 能跑命令行的 Agent 都能用，看的是同一份说明。
  • 输出 JSON，退出码清楚：0 成功，1 接口或网络出错，2 用法不对，3 任务失败或取消，4 等待超时但任务还在跑（再等一次就行）。
  • 想自己写程序调？同样的功能都在 HTTP 接口里（英文）。

花多少、等多久

视频夜里（新加坡时间 22:00–次日 10:00）每秒 ¥0.06，白天每秒 ¥0.09，比 MiniMax 官方 API 最多便宜 80%。1080P 两倍。提交时冻结积分，出片成功才扣，失败退回。

一条 6 秒的 768P 视频，开始生成后大约 3 分钟出来，排队时间另算。Agent 会自己等着、查进度。

常见问题

Codex 也能用吗，不只是 Claude Code？

能。能读网页、能跑命令行的 Agent 都行，交给它同一句话就可以。

要把 API Key 交给 Agent 吗？

不用。Agent 发来授权链接，你点确认后它拿到自己的 Key，你随时可以在「API Key」页吊销。

怎么防止 Agent 花掉太多积分？

每条提交前 Agent 都会告诉你要冻结多少积分；它的说明里要求一次超过 1,000 积分、或者要连着提交一批时先问你。你也随时能查余额和流水，或者吊销它的 Key。

成片能商用吗？

能。生成的视频归你，遵守用户协议就行。

相关教程