Minimax Mcode Byok
БесплатноНе проверенMiniMax (Hailuo H3) video generation BYOK MCP server for mcode — wraps the official /v2/video_generation API with your own API key
Описание
MiniMax (Hailuo H3) video generation BYOK MCP server for mcode — wraps the official /v2/video_generation API with your own API key
README
MiniMax(海螺 H3)视频生成 BYOK MCP Server,为 mcode(Minimax Code CLI)设计。
把 mcode 内置 Matrix 的 submit_video_generation / query_video_generation 两个工具移植到官方开放平台 V2 API,用你自己的 API Key 鉴权(BYOK,Bring Your Own Key)——视频生成按开放平台计费(积分/按量),不占用 mcode 订阅套餐(Token Plan)的视频条数和周限额。
非官方社区工具,与 MiniMax 公司无隶属关系。接口以开放平台文档为准。
适用场景
- mcode 已登录(OAuth 订阅)状态下,内置 Matrix 视频工具与本项目并存不冲突(MCP 工具名自动带 server 前缀),可按需选择走订阅额度还是走 API Key
- 订阅的每日视频条数用完,还想继续生成
- 想把视频生成费用与订阅额度分开结算
工作方式
mcode (TUI/ACP) ──MCP stdio──> mcp-server.mjs ──HTTPS──> 官方开放平台 API
POST /v2/video_generation (提交,得 task_id)
GET /v2/query/video_generation/ (轮询,取结果 URL)
暴露两个工具(入参与内置 Matrix 版对齐):
| 工具 | 作用 |
|---|---|
submit_video_generation |
提交异步视频任务,立即返回 task_id |
query_video_generation |
查询状态;succeeded 时自动把 mp4 下载到你指定的路径(签名 URL 约 9 小时有效,落盘不担心过期) |
请求标识:以 mcode 客户端身份发出
本 server 的所有 API 请求默认携带 User-Agent: MiniMaxCode——与 mcode 调用开放平台 API 时使用的客户端标识一致。因此即使走的是 API Key(BYOK)格式,请求在服务端遥测/风控视角也呈现为 mcode 客户端发出,与 mcode 自身的 BYOK 模式行为对齐。
- 鉴权与计费不受影响:仍用你自己的 API Key,费用归属 Key 所属账户(按量/积分),不动订阅额度
- 如需自定义,用环境变量
MINIMAX_VIDEO_UA覆盖(设为""之外的任意值)
安装
前置:已安装 mcode(Minimax Code CLI);Node.js 18+(mcode 自带 runtime 也可)。
获取 API Key:platform.minimax.cn(国际站 platform.minimaxi.com)→ 账户管理 → 接口密钥
克隆本仓库(路径任意,记住
mcp-server.mjs的完整路径):git clone https://github.com/Hylouis233/minimax-mcode-byok.git注册到 mcode:编辑 mcode 用户级 MCP 配置
~/.minimax/mcp.json(Windows 为C:\Users\<你>\.minimax\mcp.json;文件已存在则把条目合并进已有的mcpServers):{ "mcpServers": { "minimax-mcode-byok": { "command": "node", "args": ["C:\\path\\to\\minimax-mcode-byok\\mcp-server.mjs"], "env": { "MINIMAX_API_KEY": "你的开放平台APIKey", "MINIMAX_VIDEO_API_BASE": "https://api.minimax.cn" }, "enabled": true, "description": "MiniMax 视频生成 BYOK(官方 V2 API,按 API Key 计费)" } } }node不在 PATH 时,可改用 mcode 自带 Node 的完整路径,如%USERPROFILE%\.minimax-code\runtime\node-v22.19.0-win-x64\node.exe(版本号以本机为准)- 国际站账号把
MINIMAX_VIDEO_API_BASE改为https://api.minimaxi.com
重启 mcode,在 TUI 里直接说人话即可,例如:
用 minimax-mcode-byok 生成一个 6 秒 2K 视频:夜晚的赛博朋克街道,霓虹雨幕,说一句"欢迎回家"
模型、时长(H3 4–15 秒、H3-Max 5–15 秒)、分辨率(768P/2K)、比例它会先问你;任务完成后 mp4 自动保存到工作区。
支持的输入
- 模型:
MiniMax-H3(质量档,768P/2K)、MiniMax-H3-Max(极速档,480P/768P) - 模式:纯文生视频 / 首帧·尾帧·首+尾帧 / 多模态参考(参考图 ≤9、参考视频 ≤3、参考音频 ≤3,总数 ≤12)
- 媒体:公网 HTTP(S) URL 与
mm_file://直接透传;本地文件自动转 base64(受官方 64MB 请求体上限,大文件请用公网 URL) - H3 原生同步出音:对白、环境音、音效写进 prompt 即可
限制
MiniMax-Hailuo-2.3走旧版 V1 接口,本工具不包装(调用会返回明确提示)——H2.3 请继续用 mcode 内置 Matrix 工具- 任务查询窗口 7 天
- 计费按 API Key 走开放平台(参考价:国内站 2K ≈ ¥0.8/秒、768P ≈ ¥0.5/秒,以价格页为准)
排障
| 现象 | 处理 |
|---|---|
1004 login fail / 401 |
API Key 错误,或 Key 与 MINIMAX_VIDEO_API_BASE 站点不匹配(cn 的 Key 别配 minimaxi.com) |
| 工具没出现在 mcode | 检查 mcp.json 是合法 JSON、args 路径正确、node 可用;重启 mcode |
credits_exhausted / 402 |
开放平台余额不足,充值或换 Key |
| 大视频文件报超过 64MB | 改用公网 URL 引用 |
License
Установка Minimax Mcode Byok
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/Hylouis233/minimax-mcode-byokFAQ
Minimax Mcode Byok MCP бесплатный?
Да, Minimax Mcode Byok MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Minimax Mcode Byok?
Нет, Minimax Mcode Byok работает без API-ключей и переменных окружения.
Minimax Mcode Byok — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Minimax Mcode Byok в Claude Desktop, Claude Code или Cursor?
Открой Minimax Mcode Byok на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
ARA
Generate images, video and audio from any AI agent — one connector.
автор: ARAVideo Analyzer
MCP server for video analysis — extracts transcripts, key frames with OCR, and annotated timelines from video URLs. Supports Loom and direct video files (.mp4,
автор: guimatheus92Omni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
автор: buildwithtazaYouTube
Transcripts, channel stats, search
автор: YouTubeEverArt
AI image generation using various models.
автор: modelcontextprotocolgpu-bridge/mcp-server
GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.
автор: gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
автор: merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
автор: SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
автор: YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
автор: AceDataCloudCompare Minimax Mcode Byok with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории media
