前言¶
在 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：
