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