langgenius/dify-plugins
1
0
Fork 0
mirror of https://github.com/langgenius/dify-plugins.git synced 2026-07-22 01:55:36 -04:00
Code Issues 119 Packages Projects Releases Wiki Activity

[PR #1942] [CLOSED] 新增即梦3.0pro接口调用 #1972

New Issue
Closed
opened 2026-02-22 18:13:17 -05:00 by yindo · 0 comments
yindo commented 2026-02-22 18:13:17 -05:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langgenius/dify-plugins/pull/1942
Author: @shaoruidong
Created: 1/22/2026
Status: ❌ Closed

Base: main ← Head: main

📝 Commits (1)

  • c8eeed4 新增即梦3.0pro接口调用

📊 Changes

1 file changed (+0 additions, -0 deletions)

View changed files

➕ shaoruidong/shaoruidong-volcengine_ai_0.0.2.difypkg (+0 -0)

📄 Description

插件提交表单 (Plugin Submission Form)

1. 元数据 (Metadata)

2. 提交类型 (Submission Type)

  • 新插件提交 (New plugin submission)
  • 现有插件版本更新 (Version update for existing plugin)

3. 描述 (Description)

插件简介

火山引擎AI插件为Dify提供强大的视觉AI能力，集成了火山引擎（Volcengine）的即梦AI系列模型，支持文生图、图生图、文生视频、图生视频等多种AI创作功能。

核心功能

本插件包含7个专业的AI视觉工具：

图像生成工具

  1. 高美感通用3.0文生图 (HighAesGeneralV30LZT2I)

    • 新一代文生图模型，基于字节跳动视觉大模型
    • 支持2048以下分辨率直出
    • 显著提升图文理解、结构准确性和美学表现

  2. 人像写真 (I2IPortraitPhoto)

    • 基于单张真人照片生成多样化写真照片
    • 支持文本引导的风格转换
    • 适用于互动娱乐、照片特效、电商营销

  3. 智能绘画3.0 (SeededitV30)

    • 图生图编辑模型，支持基于文本提示修改图像
    • 精准遵循编辑指令，有效保留图像内容
    • 擅长处理真实图像，保持人物特征和细节

  4. 即梦高美感通用2.1 (JimengHighAESGeneralV21L)

    • 文生图API，准确理解文本生成高美学图像
    • 支持中英文字符渲染
    • 实现"所见即所想"的创意表达

视频生成工具

  1. 即梦视频生成2.0 - 文生视频 (JimengVGFMT2VL20)

    • 支持纯文本生成视频
    • 深度理解文本指令，生成流畅视频
    • 支持多维参数精细调节

  2. 即梦视频生成2.0 - 图生视频 (JimengVGFMI2VL20)

    • 支持首帧图片生成视频
    • 深度理解图像指令，生成流畅视频
    • 提供专业级视频生成体验

  3. 即梦视频生成3.0 Pro (JimengVGFMT2VL30Pro) ⭐ 最新

    • 新一代视频生成API，支持文生视频和图生视频
    • 多镜头叙事能力：支持复杂镜头切换、人物动作、物体运动轨迹
    • 灵活参数配置：6种宽高比、2种时长、随机种子控制
    • 多种输入方式：支持文件上传、URL、Base64三种图片输入
    • 高质量输出：增强的语义理解和视频质量

技术特点

  • ✅ 完整的SDK集成：基于火山引擎官方SDK，确保API调用的稳定性和安全性
  • ✅ 异步任务处理：智能轮询机制，支持长时间视频生成任务
  • ✅ 参数验证：完善的参数互斥验证，防止用户误操作
  • ✅ 多语言支持：中文、英文、葡萄牙语三语界面
  • ✅ 错误处理：友好的错误提示和异常处理机制
  • ✅ 安全认证：HMAC-SHA256签名认证，保护API密钥安全

适用场景

  • 🎨 内容创作：自媒体、短视频制作、营销素材生成
  • 🎬 视频制作：广告片、宣传片、产品演示视频
  • 🖼️ 图像设计：海报设计、插画创作、产品图生成
  • 📸 照片处理：人像美化、风格转换、图像编辑
  • 🤖 AI应用：智能客服、虚拟助手、创意工具

特别说明

本插件基于 @parkerwen 开发的原始火山引擎AI插件进行扩展。

特别感谢 parkerwen 为Dify社区贡献了优秀的插件基础框架，包括完整的SDK集成、规范的代码结构和详细的文档。在此基础上，我们新增了即梦AI-视频生成3.0 Pro工具，进一步丰富了插件功能。

原作者: parkerwen
扩展开发: shaoruidong

4. 检查清单 (Checklist)

  • 我已阅读并遵循《发布到Dify市场指南》
  • 我已阅读并遵守《插件开发者协议》
  • 我确认插件在Dify社区版和云版本上均可正常工作
  • 我确认插件已经过完整性和功能性的全面测试
  • 我的插件为Dify带来了新的价值

5. 文档检查清单 (Documentation Checklist)

  • 分步设置说明
  • 详细的使用说明
  • 清晰列出所有必需的API和凭证
  • 连接要求和配置详情
  • 插件源代码仓库链接

文档内容概览

README.md

  • ✅ 插件概述和功能介绍
  • ✅ 火山引擎账号注册和实名认证步骤
  • ✅ 服务激活和AccessKey获取指南
  • ✅ Dify中的配置步骤（含截图）
  • ✅ 所有7个工具的详细说明
  • ✅ 使用场景和示例

配置要求

前置条件

  1. 注册火山引擎账号并完成实名认证
  2. 在火山引擎控制台激活相应服务
  3. 获取AccessKey和SecretKey
  4. 确保账户有足够的余额（按量计费）

6. 隐私保护信息 (Privacy Protection Information)

基于Dify插件隐私保护指南：

数据收集 (Data Collection)

本插件在运行时会收集和处理以下类型的数据：

数据类型 描述 用途
文本提示词 用户输入的文本描述 用于指导图像/视频生成
图像/视频输入 上传的图片文件、URL或Base64编码 作为生成的输入素材
生成参数 宽度、高度、种子、宽高比等 控制生成结果的特性
API凭证 AccessKeyID和AccessKeySecret 用于火山引擎API认证

重要说明：

  • ❌ 不收集任何个人身份信息（PII）
  • ❌ 不存储用户上传的图片或生成的内容
  • ❌ 不记录用户的提示词或创作内容
  • ✅ 所有数据仅在内存中处理，调用结束后立即释放
  • ✅ API凭证通过安全的运行时环境传递，不会被记录或泄露

数据使用 (Data Usage)

收集的数据仅用于以下目的：

  1. 调用火山引擎API执行图像/视频生成任务
  2. 提交和轮询异步任务结果
  3. 返回生成结果（URL、文件或JSON格式）

生成的内容或元数据不会在调用生命周期之外存储或重用。

数据存储 (Data Storage)

  • ❌ 插件不会在磁盘或外部存储中持久化任何数据
  • ✅ 所有媒体和提示词在内存中处理，使用后立即释放
  • ✅ 发送到火山引擎服务器的临时数据受其数据保留政策约束

第三方共享 (Third-Party Sharing)

数据仅与火山引擎共享，用于视觉处理服务。我们不会与其他第三方共享任何数据。

详情请参阅：火山引擎隐私政策

凭证处理 (Credential Handling)

  • ✅ API凭证通过 self.runtime.credentials 在运行时注入
  • ✅ 凭证永远不会被记录、传输到其他服务或暴露在插件执行环境之外
  • ✅ 使用HTTPS加密传输所有API通信
  • ✅ 凭证验证失败时通过 ToolProviderCredentialValidationError 安全处理

数据安全 (Data Security)

实施的安全措施：

  • 🔒 所有API通信使用HTTPS加密
  • 🔒 用户数据不写入磁盘或持久日志
  • 🔒 二进制数据在内存中处理，使用后清除
  • 🔒 外部请求使用安全的流式访问
  • 🔒 HMAC-SHA256签名认证保护API调用

用户控制 (User Control)

用户负责：

  • ✅ 确保上传的图像/视频内容不包含敏感或个人信息
  • ✅ 安全管理自己的API密钥
  • ✅ 根据隐私偏好配置运行时参数

隐私政策 (Privacy Policy)

  • 我确认已根据插件隐私保护指南准备并包含隐私政策
  • 隐私政策文件：PRIVACY.md
  • 隐私政策已包含在插件包中
  • 隐私政策符合Dify插件隐私保护指南的所有要求

7. 测试报告 (Testing Report)

测试环境

  • ✅ Dify Community Edition (本地部署)
  • ✅ Dify Cloud Version (云端测试)
  • ✅ Python 3.12
  • ✅ 架构：amd64, arm64

功能测试

图像生成工具测试

  • HighAesGeneralV30LZT2I - 文生图功能正常
  • I2IPortraitPhoto - 人像写真生成正常
  • SeededitV30 - 图像编辑功能正常
  • JimengHighAESGeneralV21L - 文生图功能正常

视频生成工具测试

  • JimengVGFMT2VL20 - 文生视频功能正常
  • JimengVGFMI2VL20 - 图生视频功能正常
  • JimengVGFMT2VL30Pro - 文生视频功能正常 ✅
  • JimengVGFMT2VL30Pro - 图生视频功能正常 ✅
  • JimengVGFMT2VL30Pro - 多镜头叙事功能正常 ✅
  • JimengVGFMT2VL30Pro - 参数互斥验证正常 ✅

参数测试

  • 所有必需参数验证正常
  • 可选参数默认值正常
  • 参数互斥逻辑正常
  • 错误提示清晰友好

异常处理测试

  • 无效凭证处理正常
  • API调用失败处理正常
  • 超时处理正常
  • 文件上传错误处理正常

性能测试

  • 图像生成响应时间：10-30秒
  • 视频生成响应时间：60-180秒
  • 内存使用正常（< 256MB）
  • 无内存泄漏

8. 附加信息 (Additional Information)

版本信息

  • 当前版本: 0.0.1
  • 发布日期: 2025-01-22
  • 最低Dify版本: 0.12.0

依赖项

requests>=2.31.0
dify-plugin>=0.1.0

支持的语言

  • 🇨🇳 简体中文
  • 🇺🇸 English
  • 🇧🇷 Português

许可证

MIT License

联系方式

致谢

特别感谢 @parkerwen 开发的原始火山引擎AI插件，为本次扩展提供了坚实的基础。

提交声明 (Submission Statement)

我确认：

  • ✅ 以上所有信息真实准确
  • ✅ 插件已经过充分测试
  • ✅ 插件符合Dify插件开发规范
  • ✅ 插件遵守隐私保护指南
  • ✅ 插件为Dify社区带来价值
  • ✅ 我已获得原作者parkerwen的许可进行扩展���发

提交人: shaoruidong
提交日期: 2025-01-22

感谢Dify团队的审核！期待插件能够为更多用户提供价值。 🎉

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langgenius/dify-plugins/pull/1942 **Author:** [@shaoruidong](https://github.com/shaoruidong) **Created:** 1/22/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `main` --- ### 📝 Commits (1) - [`c8eeed4`](https://github.com/langgenius/dify-plugins/commit/c8eeed4645eee7c78190a2dca8f21aa398be31d6) 新增即梦3.0pro接口调用 ### 📊 Changes **1 file changed** (+0 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `shaoruidong/shaoruidong-volcengine_ai_0.0.2.difypkg` (+0 -0) </details> ### 📄 Description # 插件提交表单 (Plugin Submission Form) ## 1. 元数据 (Metadata) - **插件作者 (Plugin Author)**: shaoruidong - **插件名称 (Plugin Name)**: volcengine_ai - **仓库地址 (Repository URL)**: https://github.com/shaoruidong/dify-plugin-volcengine-ai ## 2. 提交类型 (Submission Type) - [x] 新插件提交 (New plugin submission) - [ ] 现有插件版本更新 (Version update for existing plugin) ## 3. 描述 (Description) ### 插件简介 火山引擎AI插件为Dify提供强大的视觉AI能力，集成了火山引擎（Volcengine）的即梦AI系列模型，支持文生图、图生图、文生视频、图生视频等多种AI创作功能。 ### 核心功能 本插件包含7个专业的AI视觉工具： #### 图像生成工具 1. **高美感通用3.0文生图 (HighAesGeneralV30LZT2I)** - 新一代文生图模型，基于字节跳动视觉大模型 - 支持2048以下分辨率直出 - 显著提升图文理解、结构准确性和美学表现 2. **人像写真 (I2IPortraitPhoto)** - 基于单张真人照片生成多样化写真照片 - 支持文本引导的风格转换 - 适用于互动娱乐、照片特效、电商营销 3. **智能绘画3.0 (SeededitV30)** - 图生图编辑模型，支持基于文本提示修改图像 - 精准遵循编辑指令，有效保留图像内容 - 擅长处理真实图像，保持人物特征和细节 4. **即梦高美感通用2.1 (JimengHighAESGeneralV21L)** - 文生图API，准确理解文本生成高美学图像 - 支持中英文字符渲染 - 实现"所见即所想"的创意表达 #### 视频生成工具 5. **即梦视频生成2.0 - 文生视频 (JimengVGFMT2VL20)** - 支持纯文本生成视频 - 深度理解文本指令，生成流畅视频 - 支持多维参数精细调节 6. **即梦视频生成2.0 - 图生视频 (JimengVGFMI2VL20)** - 支持首帧图片生成视频 - 深度理解图像指令，生成流畅视频 - 提供专业级视频生成体验 7. **即梦视频生成3.0 Pro (JimengVGFMT2VL30Pro)** ⭐ **最新** - 新一代视频生成API，支持文生视频和图生视频 - **多镜头叙事能力**：支持复杂镜头切换、人物动作、物体运动轨迹 - **灵活参数配置**：6种宽高比、2种时长、随机种子控制 - **多种输入方式**：支持文件上传、URL、Base64三种图片输入 - **高质量输出**：增强的语义理解和视频质量 ### 技术特点 - ✅ **完整的SDK集成**：基于火山引擎官方SDK，确保API调用的稳定性和安全性 - ✅ **异步任务处理**：智能轮询机制，支持长时间视频生成任务 - ✅ **参数验证**：完善的参数互斥验证，防止用户误操作 - ✅ **多语言支持**：中文、英文、葡萄牙语三语界面 - ✅ **错误处理**：友好的错误提示和异常处理机制 - ✅ **安全认证**：HMAC-SHA256签名认证，保护API密钥安全 ### 适用场景 - 🎨 **内容创作**：自媒体、短视频制作、营销素材生成 - 🎬 **视频制作**：广告片、宣传片、产品演示视频 - 🖼️ **图像设计**：海报设计、插画创作、产品图生成 - 📸 **照片处理**：人像美化、风格转换、图像编辑 - 🤖 **AI应用**：智能客服、虚拟助手、创意工具 ### 特别说明 本插件基于 **[@parkerwen](https://github.com/parkerwen)** 开发的原始火山引擎AI插件进行扩展。 **特别感谢 parkerwen** 为Dify社区贡献了优秀的插件基础框架，包括完整的SDK集成、规范的代码结构和详细的文档。在此基础上，我们新增了即梦AI-视频生成3.0 Pro工具，进一步丰富了插件功能。 **原作者**: parkerwen **扩展开发**: shaoruidong ## 4. 检查清单 (Checklist) - [x] 我已阅读并遵循《发布到Dify市场指南》 - [x] 我已阅读并遵守《插件开发者协议》 - [x] 我确认插件在Dify社区版和云版本上均可正常工作 - [x] 我确认插件已经过完整性和功能性的全面测试 - [x] 我的插件为Dify带来了新的价值 ## 5. 文档检查清单 (Documentation Checklist) - [x] 分步设置说明 - [x] 详细的使用说明 - [x] 清晰列出所有必需的API和凭证 - [x] 连接要求和配置详情 - [x] 插件源代码仓库链接 ### 文档内容概览 #### README.md - ✅ 插件概述和功能介绍 - ✅ 火山引擎账号注册和实名认证步骤 - ✅ 服务激活和AccessKey获取指南 - ✅ Dify中的配置步骤（含截图） - ✅ 所有7个工具的详细说明 - ✅ 使用场景和示例 #### 配置要求 - ✅ **AccessKeyID**: 火山引擎账号的访问密钥ID - ✅ **AccessKeySecret**: 火山引擎账号的访问密钥Secret - ✅ 获取方式：[火山引擎控制台 - 密钥管理](https://console.volcengine.com/iam/keymanage/) #### 前置条件 1. 注册火山引擎账号并完成实名认证 2. 在火山引擎控制台激活相应服务 3. 获取AccessKey和SecretKey 4. 确保账户有足够的余额（按量计费） ## 6. 隐私保护信息 (Privacy Protection Information) 基于Dify插件隐私保护指南： ### 数据收集 (Data Collection) 本插件在运行时会收集和处理以下类型的数据： | 数据类型 | 描述 | 用途 | |---------|------|------| | **文本提示词** | 用户输入的文本描述 | 用于指导图像/视频生成 | | **图像/视频输入** | 上传的图片文件、URL或Base64编码 | 作为生成的输入素材 | | **生成参数** | 宽度、高度、种子、宽高比等 | 控制生成结果的特性 | | **API凭证** | AccessKeyID和AccessKeySecret | 用于火山引擎API认证 | **重要说明**： - ❌ **不收集**任何个人身份信息（PII） - ❌ **不存储**用户上传的图片或生成的内容 - ❌ **不记录**用户的提示词或创作内容 - ✅ 所有数据仅在内存中处理，调用结束后立即释放 - ✅ API凭证通过安全的运行时环境传递，不会被记录或泄露 ### 数据使用 (Data Usage) 收集的数据**仅用于**以下目的： 1. 调用火山引擎API执行图像/视频生成任务 2. 提交和轮询异步任务结果 3. 返回生成结果（URL、文件或JSON格式） 生成的内容或元数据**不会**在调用生命周期之外存储或重用。 ### 数据存储 (Data Storage) - ❌ 插件**不会**在磁盘或外部存储中持久化任何数据 - ✅ 所有媒体和提示词在**内存中处理**，使用后立即释放 - ✅ 发送到火山引擎服务器的临时数据受其数据保留政策约束 ### 第三方共享 (Third-Party Sharing) 数据**仅与火山引擎共享**，用于视觉处理服务。我们**不会**与其他第三方共享任何数据。 详情请参阅：[火山引擎隐私政策](https://www.volcengine.com/docs/6460/112241) ### 凭证处理 (Credential Handling) - ✅ API凭证通过 `self.runtime.credentials` 在运行时注入 - ✅ 凭证**永远不会**被记录、传输到其他服务或暴露在插件执行环境之外 - ✅ 使用HTTPS加密传输所有API通信 - ✅ 凭证验证失败时通过 `ToolProviderCredentialValidationError` 安全处理 ### 数据安全 (Data Security) 实施的安全措施： - 🔒 所有API通信使用HTTPS加密 - 🔒 用户数据不写入磁盘或持久日志 - 🔒 二进制数据在内存中处理，使用后清除 - 🔒 外部请求使用安全的流式访问 - 🔒 HMAC-SHA256签名认证保护API调用 ### 用户控制 (User Control) 用户负责： - ✅ 确保上传的图像/视频内容不包含敏感或个人信息 - ✅ 安全管理自己的API密钥 - ✅ 根据隐私偏好配置运行时参数 ### 隐私政策 (Privacy Policy) - [x] 我确认已根据插件隐私保护指南准备并包含隐私政策 - [x] 隐私政策文件：`PRIVACY.md` - [x] 隐私政策已包含在插件包中 - [x] 隐私政策符合Dify插件隐私保护指南的所有要求 ## 7. 测试报告 (Testing Report) ### 测试环境 - ✅ Dify Community Edition (本地部署) - ✅ Dify Cloud Version (云端测试) - ✅ Python 3.12 - ✅ 架构：amd64, arm64 ### 功能测试 #### 图像生成工具测试 - [x] HighAesGeneralV30LZT2I - 文生图功能正常 - [x] I2IPortraitPhoto - 人像写真生成正常 - [x] SeededitV30 - 图像编辑功能正常 - [x] JimengHighAESGeneralV21L - 文生图功能正常 #### 视频生成工具测试 - [x] JimengVGFMT2VL20 - 文生视频功能正常 - [x] JimengVGFMI2VL20 - 图生视频功能正常 - [x] JimengVGFMT2VL30Pro - 文生视频功能正常 ✅ - [x] JimengVGFMT2VL30Pro - 图生视频功能正常 ✅ - [x] JimengVGFMT2VL30Pro - 多镜头叙事功能正常 ✅ - [x] JimengVGFMT2VL30Pro - 参数互斥验证正常 ✅ ### 参数测试 - [x] 所有必需参数验证正常 - [x] 可选参数默认值正常 - [x] 参数互斥逻辑正常 - [x] 错误提示清晰友好 ### 异常处理测试 - [x] 无效凭证处理正常 - [x] API调用失败处理正常 - [x] 超时处理正常 - [x] 文件上传错误处理正常 ### 性能测试 - [x] 图像生成响应时间：10-30秒 - [x] 视频生成响应时间：60-180秒 - [x] 内存使用正常（< 256MB） - [x] 无内存泄漏 ## 8. 附加信息 (Additional Information) ### 版本信息 - **当前版本**: 0.0.1 - **发布日期**: 2025-01-22 - **最低Dify版本**: 0.12.0 ### 依赖项 ``` requests>=2.31.0 dify-plugin>=0.1.0 ``` ### 支持的语言 - 🇨🇳 简体中文 - 🇺🇸 English - 🇧🇷 Português ### 许可证 MIT License ### 联系方式 - **GitHub**: https://github.com/shaoruidong - **Issues**: https://github.com/shaoruidong/dify-plugin-volcengine-ai/issues ### 致谢 特别感谢 **[@parkerwen](https://github.com/parkerwen)** 开发的原始火山引擎AI插件，为本次扩展提供了坚实的基础。 --- ## 提交声明 (Submission Statement) 我确认： - ✅ 以上所有信息真实准确 - ✅ 插件已经过充分测试 - ✅ 插件符合Dify插件开发规范 - ✅ 插件遵守隐私保护指南 - ✅ 插件为Dify社区带来价值 - ✅ 我已获得原作者parkerwen的许可进行扩展���发 **提交人**: shaoruidong **提交日期**: 2025-01-22 --- **感谢Dify团队的审核！期待插件能够为更多用户提供价值。** 🎉 --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-02-22 18:13:17 -05:00
yindo closed this issue 2026-02-22 18:13:20 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Plugin Request
Plugin Request
Plugin Request
bug
duplicate
enhancement
pull-request
Mirrored from GitHub Pull Request
 question
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify-plugins#1972
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?