agnes-media：DeepSeek Harness 媒体生成插件

前言¶

DeepSeek Harness (DSH) 采用插件化架构，旨在为智能体扩展能力。当智能体需要在对话中生成图片或视频时，需要通过插件注册对应的工具。agnes-media 是为此设计的插件，它为 Agnes AI 媒体模型注册了工具，使智能体能够执行文生图、文生视频和图生视频操作。

插件简介¶

名称：agnes-media
作者：LittleBeaverStudio
类别：模型推理
许可：MIT
核心功能：文生图、文生视频、图生视频、免费无限、国内直连、凭证集成、零依赖。

前置要求¶

DeepSeek Harness 0.1.0-rc.7 或更高版本。
Agnes AI 的 API Key（免费）。

安装¶

使用官方命令将插件添加到 web 配置文件中：

dsh plugin --profile web add github:LittleBeaverStudio/agnes-media

安装完成后重启 DSH 服务器，generate_image 和 generate_video 两个工具将出现在智能体的工具目录中。

配置¶

插件支持通过环境变量或 DSH credentials 系统配置 API Key。

环境变量¶

AGNES_MEDIA_API_KEY：API Key（推荐）。
AGNES_API_KEY：备用 API Key。
AGNES_MEDIA_BASE_URL：自定义端点。默认为 https://apihub.agnes-ai.cn。海外用户可配置为 https://apihub.agnes-ai.com。

DSH Credentials¶

在 DSH Web UI 的凭证管理中添加 AGNES_MEDIA_API_KEY 即可。

注意：API Key 与端点存在代际绑定。国内签发的 Key 通常在 apihub.agnes-ai.cn 有效，海外签发的 Key 在 apihub.agnes-ai.com 有效。如果遇到 401 错误，请检查端点与 Key 的匹配情况。

工具使用¶

generate_image¶

使用 agnes-image-2.5-flash 模型生成图片。

参数：
- prompt（必需）：图片描述。
- size（可选）：输出尺寸，格式 "WxH"，默认 1024x1024。
- n（可选）：生成数量，默认 1，最大 4。

返回值：公共 HTTPS URL 数组。

generate_video¶

使用 agnes-video-2.5-flash 模型生成视频。

参数：
- prompt（必需）：视频描述。
- duration（可选）：时长（秒），范围 4-12，默认 5。
- aspect_ratio（可选）：宽高比，如 "16:9"，默认 "16:9"。
- size（可选）：分辨率档位。Flash 模型固定 720P。
- reference_image_url（可选）：参考图 URL。传入后进入图生视频模式。

返回值：视频 URL。

注意事项：
- 该操作是异步的，插件会轮询状态直到完成。
- 支持遇到 429 限流时的退避重试。
- negative_prompt 参数已废弃，但保留定义以避免报错。

注意事项¶

分辨率：视频模型固定为 720P。
Key 绑定：API Key 与平台端点存在代际绑定，请确保 Key 与配置的 BASE_URL 一致。
DSH 版本：需使用 0.1.0-rc.7 或更高版本。

参考资料¶

插件目录：https://www.skillhub.cn/plugins/LittleBeaverStudio/agnes-media
GitHub：https://github.com/LittleBeaverStudio/agnes-media