前言¶

在 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