前言¶

在 DeepSeek Harness（DSH）裏擴展智能體能力時，如果工具需要調用外部生成服務，往往要處理鑑權、任務提交、結果輪詢和輸出地址返回。dsh-plugin-muapi 將 MuApi 的圖像、視頻和音頻生成模型封裝爲 DSH 工具，減少這類膠水代碼。

這是什麼¶

SamurAIGPT/dsh-plugin-muapi 是一個由 SamurAIGPT 維護的 DeepSeek Harness 插件，許可證爲 MIT。它註冊一個名爲 muapi_generate 的工具，把 MuApi 的 100+ 圖像、視頻和音頻生成模型暴露給 agent。

核心功能¶

插件註冊的工具是：

muapi_generate

該工具通過 model 字段選擇 MuApi 模型 slug，通過 input 字段傳該模型的參數對象。例如：

{
  "model": "flux-schnell-image",
  "input": {
    "prompt": "a serene mountain lake at dawn"
  }
}

上面示例中，model 是 MuApi 模型 slug，input 是模型參數對象。

調用 MuApi 的流程爲：

1、提交任務：

POST https://api.muapi.ai/api/v1/{model}

2、輪詢結果，直至完成或失敗：

GET https://api.muapi.ai/api/v1/predictions/{request_id}/result

3、返回輸出 URL。

可配置項與默認值如下：

tool.enabled = true
tool.apiKeyEnv = <credential reference>
tool.baseUrl = https://api.muapi.ai/api/v1
tool.pollIntervalMs = 3000
tool.timeoutMs = 600000

其中 tool.enabled 控制是否暴露工具，tool.apiKeyEnv 是 MuApi API key credential reference，tool.baseUrl 是 API 基礎地址，tool.pollIntervalMs 是輪詢間隔，tool.timeoutMs 是等待任務完成的上限。

安裝與啓用¶

先執行安裝命令：

dsh plugin add @dsh-plugin/dsh-plugin-muapi

安裝後，在設置中配置 MuApi API key credential：

Settings → muapi

可前往下面地址創建 key：

https://muapi.ai/access-keys

package.json 顯示該插件的 peerDependencies 對 @deepseek-ai/* 有版本要求，啓用前應在宿主環境中確認滿足要求：

peerDependencies
@deepseek-ai/*

如需要調整超時或輪詢行爲，可修改 tool.pollIntervalMs 和 tool.timeoutMs。

典型用法¶

在 agent 中調用時，傳入 MuApi 模型 slug 和模型參數對象即可。以圖像模型爲例：

{
  "model": "flux-schnell-image",
  "input": {
    "prompt": "a serene mountain lake at dawn"
  }
}

如果需要查看可用模型，可瀏覽 MuApi 模型目錄：

https://muapi.ai/playground

具體模型的參數文檔路徑爲：

https://muapi.ai/playground/{model}/llms.txt

例如 flux-schnell-image 或 kling-v2-1-image-to-video 這類 slug 都可在上述目錄中查找對應文檔。

適用場景與注意¶

適合需要把 MuApi 生成能力接入 DSH agent 的開發者。使用它時需要注意：

• 插件會調用外部 MuApi API，並按配置輪詢結果。
• 需要 MuApi API key；tool.apiKeyEnv 是 credential reference，不應把密鑰硬編碼進配置。
• 默認 tool.timeoutMs 爲 600000，生成任務超過該上限會失敗。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼、許可證和依賴。
• DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應把它理解爲官方應用商店。

結尾¶

dsh-plugin-muapi 的價值在於把 MuApi 的任務提交、輪詢和輸出 URL 返回收斂到一個 DSH 工具中。可以在目錄頁查看：

https://www.skillhub.cn/plugins/SamurAIGPT/dsh-plugin-muapi

源碼倉庫爲：

https://github.com/SamurAIGPT/dsh-plugin-muapi