前言¶
在 DeepSeek Harness（DSH）里做多模型编排时，常见做法是对接各家 OpenAPI：对话走模型选择器，生图、视频、语音则另写脚本或单独工具。MiniMax 开放平台同时提供按量 API Key 和订阅（M Plan / Coding Plan）Key，主机与聊天协议（OpenAI 兼容或 Anthropic 兼容）需要配对，密钥也不适合写进明文配置。
下面介绍社区插件 dsh-minimax-byapi（维护者 NingYuanLee，npm 包名同插件 id，当前发布版本 0.1.2，MIT 许可证）。它向 DSH 注册原生 LLM Provider 路由 minimax-byapi，并把图像、视频、语音、音乐等能力以工具形式挂到会话里；密钥存放在 DSH 凭证服务，生成的媒体落盘本地。插件对接的是 MiniMax 官方开放平台，不做 OAuth，也不代管账号额度。
这是什么¶
一句话：一条 MiniMax 连接，聊天进模型选择器，多媒体走工具。
注册两个组件：minimax-byapi（对话、模型目录、设置页）与 dsh-minimax-media（媒体工具）。任意聊天模型（不限于 MiniMax）都可以调用这些工具。
分类上属于「模型推理」；GitHub 仓库 NingYuanLee/dsh-minimax-byapi 与社区目录 SkillHub 条目 可自行对照源码与说明。社区插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
对话与模型目录¶
- 以显示名 MiniMax 出现在 DSH 模型选择器；流式文本与 tool call 经官方 pi-ai 适配器，可走 OpenAI 兼容或 Anthropic 兼容路由。
- 通过
GET {root}/v1/models发现模型，并与插件内置常量合并，按能力划分为 chat、image、video、speech、music、research 等；仅 chat 模型进入选择器。 - 五种连接预设：国际 / 国内按量（pay-as-you-go）、国际 / 国内 M Plan 订阅，以及自定义端点；预设会填充 Base URL 与聊天协议。
十三个媒体与辅助工具¶
插件共注册 13 个工具，例如：
| 工具 | 作用（摘要） |
|---|---|
minimax_models |
刷新目录并按能力分组；可选 verify_key 用一次 GET /v1/models 校验地址与密钥 |
minimax_quota |
读取 M Plan 剩余额度与重置时间（仅订阅 Key；按量 Key 会拒绝） |
minimax_generate_image / minimax_edit_image |
文生图、图生图 |
minimax_generate_video |
文生视频（V2 / V1 模型时长规则不同） |
minimax_list_voices / minimax_speak / minimax_speak_long |
音色列表、同步 / 异步长文本 TTS |
minimax_transcribe |
语音转文字 |
minimax_generate_music |
文生音乐（MiniMax 已下线该能力，见仓库 Music 章节） |
minimax_media_list / minimax_media_status / minimax_media_retry_download |
会话内任务列表、拉取结果、失败下载重试（不重复计费生成） |
媒体任务按会话持久化，重启不丢；下载使用 .part 文件，校验通过后重命名。工具结果以卡片、预览和侧边栏播放器（MP4、MP3、WAV）展示。
未提供：实时语音对话、克隆/设计音色、MiniMax 服务端网页搜索工具、实时任务看板；视频提交后在进程内轮询，卡片是快照，需再调 minimax_media_status 取成品文件。
密钥与连接方式¶
两类 Key 在链路上用法相同（Authorization: Bearer <key>），区别在于计费和可用模型档位：
| 按量 API Key | M Plan 订阅 Key | |
|---|---|---|
| 前缀 | 普通 Key | sk-cp-… |
| 计费 | 账户余额 | 先扣 M Plan 额度，再积分，再余额 |
凭证引用名为 MINIMAX_API_KEY，由 DSH 凭证服务保存，不会写入插件配置 JSON。
connection.plan 与官方主机配对示例（资料原文）：
| Plan | Base URL | Chat protocol |
|---|---|---|
payg-global |
https://api.minimax.io/v1 |
openai-completions |
payg-cn |
https://api.minimaxi.com/v1 |
openai-completions |
coding-global |
https://api.minimax.io/anthropic |
anthropic-messages |
coding-cn |
https://api.minimaxi.com/anthropic |
anthropic-messages |
custom |
自备 | openai-completions |
国内还可使用 api.minimax.cn；与 api.minimaxi.com 行为一致时可切 custom 换主机写法。
环境要求¶
| 组件 | 要求 |
|---|---|
| Node.js | >=22.19.0 |
| dsh | >=0.2.1-rc.2 <0.3.0-0 或 >=0.2.2-0 <0.3.0-0（以 engines.dsh 为准） |
| MiniMax | 官方开放平台（国际 api.minimax.io 或国内上述主机） |
升级 dsh 后建议按仓库说明重跑集成测试；真实 Key 下的对话与媒体调用需自行在目标环境验证（见仓库 VALIDATION.md）。
安装与启用¶
包已发布到 npm。在 DSH 中安装 released 包：
dsh plugin add dsh-minimax-byapi
安装完成后，在插件设置页选择接入模式（Access mode）、填写 API 地址与 Key、执行校验，并确认聊天模型表（选择器的数据源）与媒体模型选项。界面文案随 dsh 语言（中 / 英）切换。
典型用法¶
- 安装插件，在凭证或设置流程中配置
MINIMAX_API_KEY，并选对payg-*或coding-*预设（M Plan 须用sk-cp-前缀 Key 且走 Anthropic 路由主机）。 - 对话：在模型选择器选 MiniMax 下某一 chat 模型进行流式聊天与 tool call。
- 查额度（仅订阅）：让智能体调用
minimax_quota。 - 刷新模型列表：调用
minimax_models；需要时可带verify_key做连通性检查。 - 生成媒体：由当前会话中的模型调用对应工具（如
minimax_generate_image、minimax_generate_video、minimax_speak）；异步长语音用minimax_speak_long取得task_id，再用minimax_media_status下载。 - 失败重试：下载失败时用
minimax_media_retry_download，避免再次调用生成接口重复扣费。
具体参数（prompt、aspect ratio、voice_id、模型名等）以工具 schema 与 GitHub README 为准。
适用场景与注意¶
适合：已在 DSH 里编排智能体、希望用同一套 Harness 完成 MiniMax 对话与官方多媒体 API 的开发者；需要区分国内 / 国际主机与 M Plan / 按量计费路径的团队。
注意：
- 插件以 当前 dsh 进程权限 运行；安装前请阅读源码与 MIT 许可证，确认密钥与生成文件的落盘位置符合你的安全策略。
- 不提供账号注册与额度代购；计费和模型档位以 MiniMax 开放平台为准。
- 模型自动分类是规则推断，不保证与官方命名完全一致；
*_music*相关能力已被平台下线，勿依赖生产。 - 仓库 README 英文为主，另有
README.zh.md可对照。
结尾¶
dsh-minimax-byapi 把 MiniMax 官方 API 收成 DSH 原生 Provider 加一组可复用媒体工具，减少自建适配与密钥散落配置的问题。查阅说明与 issue：
