comfyui-api-image-edit 1.0.5

A powerful ComfyUI custom node for API-based image editing with multiple provider support

ComfyUI API Image Edit

一个强大的ComfyUI自定义节点，支持通过多种远程API进行图片编辑功能。

🌟 功能特性

• 🔌 多API支持: 支持阿里云千问和OpenRouter API
• 🤖 自动模型发现: 自动获取并更新支持的模型列表
• 🎨 智能图片编辑: 基于文本提示的AI图片编辑
• 🎭 蒙版支持: 支持使用蒙版进行局部编辑
• ⚡ 高效缓存: 智能缓存模型列表，减少API调用
• 🛡️ 错误处理: 完善的错误处理和回退机制

📋 支持的API提供商

1. 阿里云千问 (DashScope)

• 模型: qwen-image-edit (专用图片编辑模型), qwen-vl-max, qwen-vl-plus
• 认证: API Key (需要在环境变量DASHSCOPE_API_KEY中设置或直接输入)
• 功能: 专业的AI图片编辑，支持IP创作、文字替换、风格迁移、人物换装等

2. OpenRouter

• 模型: Google Gemini 2.5 Flash Image Preview, Gemini 2.0 Flash, LLaMA Vision 等
• 认证: API Key
• 功能: 图像理解与描述 (注意：大多数Vision模型主要用于分析而非生成图像)

🚀 安装

1. 将此文件夹复制到 ComfyUI 的 custom_nodes 目录
2. 重启 ComfyUI
3. 在节点列表中找到 "API/Image Edit" 分类

📖 使用方法

基本使用

1. 添加节点: 在ComfyUI中搜索 "API Image Edit"
2. 选择API提供商: 从下拉菜单选择 "阿里云千问" 或 "OpenRouter"
3. 输入API Key: 在API Key字段输入您的密钥
4. 选择模型: 输入模型名称或点击刷新获取可用模型列表
5. 输入提示: 在prompt字段描述您想要的编辑效果
6. 连接图片: 将图片输入连接到image接口

高级功能

• 蒙版编辑: 连接MASK输入进行局部编辑
• 参数调节:
  • strength: 编辑强度 (0.0-2.0)
  • guidance_scale: 引导强度 (1.0-20.0)
  • steps: 处理步数 (1-100)
  • seed: 随机种子 (-1为随机)
  • watermark: 是否添加水印 (阿里云千问专用)
  • negative_prompt: 负面提示词 (描述不想要的内容)

🔑 获取API密钥

阿里云千问

1. 访问 阿里云模型服务平台
2. 注册并创建API Key
3. 确保账户有足够余额

OpenRouter

1. 访问 OpenRouter
2. 注册账户并获取API Key
3. 查看支持的模型列表

⚙️ 配置说明

节点输入

必需参数:

• image: 输入图片
• api_provider: API提供商选择
• api_key: API密钥
• model: 模型名称
• prompt: 编辑提示文本

可选参数:

• mask: 编辑蒙版
• refresh_models: 刷新模型列表
• strength: 编辑强度
• guidance_scale: 引导强度
• steps: 处理步数
• seed: 随机种子
• watermark: 添加水印 (阿里云千问)
• negative_prompt: 负面提示词

🔧 故障排除

常见问题

1. API调用失败

   • 检查API Key是否正确
   • 检查网络连接
   • 确认账户余额充足

2. 模型列表为空

   • 点击刷新模型按钮
   • 检查API Key权限
   • 使用默认模型名称

3. 图片处理失败

   • 检查图片格式是否支持
   • 确认prompt是否合理
   • 尝试调整参数

调试模式

节点会在控制台输出详细的日志信息，包括:

• API调用状态
• 可用模型列表
• 错误信息和堆栈跟踪

📄 许可证

MIT License

🤝 贡献

欢迎提交Issue和Pull Request来改进这个项目！

📞 支持

如果您遇到问题或有建议，请在GitHub上创建Issue。