前言¶
DeepSeek Harness(DSH)通过插件机制扩展能力。在智能体开发中,让对话直接产出图片或视频,需要对接专门的图像/视频生成 API。手动处理 API 调用和结果落盘较为繁琐。本文介绍的 dsh-jumeng-image-video-tool 插件对接了聚梦 AI,将这一流程标准化。
是什么¶
这是一个 DeepSeek Harness 插件,由用户 lkw2731938298 维护。它位于“模型推理”分类下。核心价值在于在对话中直接调用聚梦 AI 生成图片或视频,并将结果自动落盘到本地,同时返回远程访问链接。
核心功能¶
该插件提供以下工具接口:
list_models:列出可用模型(image / video)。upload_file:上传本地图片 / 视频,换取临时参考 URL。generate_image:文生图 / 图生图;落盘 + URL。generate_video:文生视频 / 图生视频;轮询完成后落盘 + URL。
安装与启用¶
执行以下命令安装插件:
dsh plugin --profile web add https://github.com/lkw2731938298/jumeng-image-video-tool.git
安装后,在 Web UI 中刷新或重启以使插件生效。
配置与使用¶
配置 API 密钥¶
- 打开 Web UI。
- 进入 设置 → 插件 → 插件配置。
- 展开 聚梦媒体。
- 粘贴 API 密钥并保存(凭据写入数据库,而非明文文件)。
也可以设置环境变量 JUMENG_API_KEY。
基础配置项¶
apiKey/apiKeyEnv:认证方式。baseUrl:默认https://www.jumengai.com/v1(国际站为https://www.jumai.ai/v1)。imageModel/videoModel:默认模型。outputDir:默认./outputs。
典型用法¶
在对话中直接输入指令:
- 「用聚梦列一下生图模型」
- 「生成一张赛博城市夜景」
- 「用这张图生成一段 5 秒竖屏视频」
注意事项¶
- 文件限制:图片(JPEG/PNG/GIF/WEBP)最大 10MB,视频(MP4/MOV/WebM)最大 100MB。
- 时效性:上传得到的 URL 约 1 小时后失效;同一密钥每小时最多 50 个文件。
- 权限与安全:插件以当前 DSH 进程权限运行,安装前建议检查源码与许可证。
- 素材复用:若需多次复用同一素材,建议先显式调用
upload_file获取 URL,再传给生成接口。
小结¶
该插件简化了在 DeepSeek Harness 中接入聚梦 AI 的流程。完整配置与源码可在 GitHub 查看。