diff --git a/README-zh.md b/README-zh.md index ee67fed..ca7edc9 100644 --- a/README-zh.md +++ b/README-zh.md @@ -8,44 +8,34 @@ 现代化的统一 ComfyUI 插件，支持 OpenAI 兼容 API，具备增强调试功能和双模式图像处理能力。 +写这个插件主要为了简化自己的工作，通过标准化的openai接口就可是接入llm或图片生成，最近用这个节点主要在玩 gemini-2.5-flash-image 的生成（没测过gemini官方接口，我接的是openai兼容端点），效果还不错。 + +## 最近更新 +- 2025-9-2 1.0发布,亲测接入[tuzi](https://api.tu-zi.com/)和[GB](https://github.com/snailyp/gemini-balance)一点没毛病 +- 2025-8-31 插件初始化 + ## ✨ 核心特性 ### 🌐 多API来源支持 -- **灵活配置**：通过 `.env` 文件支持多个 API 提供商 +- **灵活配置**：通过 `.env` 文件支持多个 API 提供商，这样如果有多个token的渠道就不用切来切去了，可以共用。 - **动态切换**：无需重启 ComfyUI 即可切换提供商 -- **自动检测**：系统自动检测并填充提供商下拉菜单 -- **广泛兼容**：支持 OpenAI、Anthropic、自定义端点等 ### 🖼️ OpenAI 图片节点 (`flexai:openai_image`) - +![](thumb/flexai-image-node.jpg) **双模式运行：** - **编辑模式**：提供 1-4 张图片 → 使用 `images.edit` API - **生成模式**：无图片输入 → 使用 `images.generate` API -**增强特性：** -- **智能响应处理**：支持 base64 和 URL 两种响应格式 -- **自动图片下载**：URL 响应时自动下载转换 -- **增强调试模式**：详细的请求/响应日志和时间统计 -- **英文错误显示**：清晰的错误消息，无字体问题 -- **全面错误处理**：安全拒绝指导和视觉反馈 + ### 💬 OpenAI 文本节点 (`flexai:openai_text`) - +![](thumb/flexai-text-node.jpg) **多模态文本生成：** -- 纯文本或视觉语言理解 (VQA) +- 纯文本或视觉语言理解 - 支持 1-4 张参考图片，自动缩放 - 流式和非流式模式 - **调试模式**：所有操作的完整 JSON 日志记录 -### 🔧 增强调试系统 - -**新增调试功能：** -- **详细时间统计**：各处理阶段的精确计时 -- **网络监控**：HTTP 请求/响应跟踪 -- **进度指示**：长时间操作的视觉反馈 -- **错误分析**：智能错误分类和解决方案 -- **英文错误图片**：所有错误显示使用英文，避免字体问题 - ## 快速开始 ### 安装 @@ -67,7 +57,7 @@ ## 配置 -在插件根目录创建 `.env` 文件。 +在插件根目录创建 `.env` 文件,或复制 `.env.example` 文件并重命名。 ### 单一提供商 ```bash @@ -93,115 +83,6 @@ OPENAI_API_KEY_custom=your-custom-key OPENAI_API_BASE_custom=https://your-api.example.com/v1 ``` -# ComfyUI FlexAI 插件 - -现代化的 ComfyUI 插件，支持 OpenAI 兼容的 API，具备双模式图像处理能力。 - -## 功能特性 - -### 🌐 多套API来源支持 -- **灵活配置**：在 `.env` 文件中支持配置多个API提供商 -- **动态选择**：节点可以选择不同的API来源进行调用 -- **自动检测**：系统自动检测配置的提供商并填充下拉菜单 -- **无缝切换**：无需重启即可在不同提供商间切换 - -### 🖼️ OpenAI 图片节点 (`flexai:openai_image`) - -**双模式运行：** -- **编辑模式**：提供 1-4 张图片 → 使用 `images.edit` API -- **生成模式**：不提供图片 → 使用 `images.generate` API - -**核心特性：** -- 支持 1-4 张图片同时输入进行编辑 -- 基于图片输入自动检测模式 -- 现代 OpenAI Python SDK (>=1.0) 集成 -- **双响应格式支持**：自动处理 base64 和 URL 两种响应格式 -- **自动图片下载**：当 API 返回 URL 时，自动下载并转换图片 -- 全面的错误处理与视觉反馈 -- 安全系统拒绝时的友好提示 -- **增强调试模式**：详细的 JSON 请求/响应日志记录 - -### 💬 OpenAI 文本节点 (`flexai:openai_text`) - -**多模态文本生成：** -- 纯文本或视觉语言理解 (VQA) -- 支持 1-4 张参考图片，自动压缩优化 -- 流式和非流式模式 -- 不支持模型的自动降级 - -**高级特性：** -- OpenAI SDK 兼容性 (1.x 优先，0.x 回退) -- 使用统计跟踪 -- 使用 seed 的可重现生成 -- 智能图片预处理 (≤1024px 最长边) -- **增强调试模式**：流式和非流式模式的完整 JSON 请求/响应日志记录 - -## 快速开始 - -### 安装 - -1. 克隆到 ComfyUI 自定义节点目录： - ```bash - cd ComfyUI/custom_nodes - git clone https://github.com/your-repo/Comfyui-flexai.git - ``` - -2. 安装依赖： - ```bash - cd Comfyui-flexai - pip install -r requirements.txt - ``` - -3. 配置提供商（见配置章节） - -4. 重启 ComfyUI - -### 基本用法 - -**图片生成：** -``` -添加 flexai:openai_image 节点 -→ 设置提供商和模型 -→ 输入提示词 -→ 生成！ -``` - -**图片编辑：** -``` -添加 flexai:openai_image 节点 -→ 连接图片到 image_1/2/3/4 输入 -→ 设置提供商和模型 -→ 输入编辑提示词 -→ 编辑！ -``` - -## 配置 - -在插件根目录创建 `.env` 文件。 - -### 单一提供商 -```bash -OPENAI_API_KEY=your_openai_api_key_here -OPENAI_API_BASE=https://api.openai.com/v1 # 可选 -``` - -### 多提供商（推荐） -```bash -# 定义提供商列表 -OPENAI_PROVIDERS=openai,anthropic,custom - -# OpenAI -OPENAI_API_KEY_openai=sk-your-openai-key -OPENAI_API_BASE_openai=https://api.openai.com/v1 - -# Anthropic (通过 OpenAI 兼容端点) -OPENAI_API_KEY_anthropic=sk-your-anthropic-key -OPENAI_API_BASE_anthropic=https://api.anthropic.com/v1 - -# 自定义端点 -OPENAI_API_KEY_custom=your-custom-key -OPENAI_API_BASE_custom=https://your-api.example.com/v1 -``` ## 节点参数 @@ -230,352 +111,6 @@ OPENAI_API_BASE_custom=https://your-api.example.com/v1 | `stream` | 布尔 | 启用流式模式 | | `debug` | 布尔 | **启用详细调试日志** | -## 调试模式功能 - -启用调试模式 (`debug=True`) 获取全面的日志记录： - -### 🔍 API 请求/响应跟踪 -``` -============================================================ -[DEBUG] 🚀 开始图片生成请求 -[DEBUG] ⏰ 请求时间: 2024-09-01 14:30:25 -[DEBUG] 📝 提交到OpenAI Images API的原生JSON数据: -{ - "model": "dall-e-3", - "prompt": "A cute cat", - "size": "1024x1024", - "response_format": "b64_json" -} -============================================================ -[DEBUG] 📡 正在发送API请求... -[DEBUG] 💡 生成时间通常在10-60秒之间，请耐心等待... -``` - -### ⏱️ 详细时间分析 -``` -[DEBUG] 🎉 图片生成流程完成! -[DEBUG] ⏱️ 总耗时: 23.45 秒 -[DEBUG] ├─ API调用: 22.10 秒 -[DEBUG] └─ 数据解码: 1.35 秒 -``` - -### 🌐 网络下载监控 -``` -[DEBUG] 🌐 开始下载图片 -[DEBUG] 📡 发送HTTP GET请求... -[DEBUG] ✅ 下载成功! -[DEBUG] ⏱️ 下载耗时: 3.24 秒 -[DEBUG] 📏 下载数据大小: 1,234,567 字节 (1.2 MB) -[DEBUG] 🖼️ 检测到PNG格式图片 -``` - -### 🚨 智能错误分析 -- **API配置问题**：自动检测和解决方案 -- **网络问题**：详细的连接诊断 -- **模型兼容性**：支持的模型建议 -- **安全拒绝**：内容政策指导 - -## 问题诊断指南 - -### 常见问题与解决方案 - -| 错误类型 | 症状 | 解决方案 | -|----------|------|----------| -| **API密钥问题** | "API key not configured" | 检查 `.env` 文件配置 | -| **网络问题** | "Unable to connect" | 检查网络连接/代理设置 | -| **不支持的模型** | "not supported model" | 使用 `dall-e-3` 或 `dall-e-2` | -| **安全拒绝** | "safety system rejected" | 修改提示词内容 | -| **超时** | 长时间等待 | 增加超时时间或检查API状态 | - -### 调试模式的优势 -1. **性能分析**：识别处理中的瓶颈 -2. **网络诊断**：跟踪下载速度和失败 -3. **错误诊断**：获取具体的错误类型和解决方案 -4. **API监控**：查看确切的请求和响应 -5. **进度跟踪**：了解处理阶段 - -## 技术细节 - -### 增强的错误处理 -- **英文错误图片**：所有错误信息以英文显示，避免字体问题 -- **智能错误翻译**：常见错误信息的自动翻译 -- **多系统字体支持**：兼容 macOS/Linux/Windows -- **详细错误上下文**：时间戳和格式化的错误信息 - -### 响应格式兼容性 -- **Base64 响应**：直接处理各种 base64 字段格式 -- **URL 响应**：自动下载和转换 -- **智能回退**：无缝处理不同 API 提供商 -- **格式检测**：自动 PNG/JPEG 格式识别 - -### 架构设计 -- **现代 SDK**：基于 OpenAI Python SDK 1.x 构建 -- **多提供商支持**：灵活的 API 来源配置 -- **清晰结构**：统一的 `flexai:` 命名空间 -- **模块化设计**：独立的图像和文本处理工具 - -### 文件结构 -``` -Comfyui-flexai/ -├── __init__.py # 插件注册 -├── provider_config.py # 多提供商管理 -├── nodes/ -│ ├── flexai/ -│ │ ├── openai_image.py # 增强的图片节点，带调试功能 -│ │ └── openai_text.py # 增强的文本节点，带调试功能 -│ └── utils/ -│ ├── openai_standard.py # API工具，带日志记录 -│ └── images.py # 图片处理工具 -├── requirements.txt # 依赖 -└── README.md # 文档 -``` - -## 最佳实践 - -### 图片生成建议 -- 使用 `dall-e-3` 获得最高质量（较慢） -- 使用 `dall-e-2` 获得更快的生成速度 -- 遇到问题时启用调试模式 -- 保持提示词符合安全政策指导 - -### 性能优化 -- 监控调试日志中的时间瓶颈 -- 使用适当的图片尺寸（推荐 1024x1024） -- 考虑网络速度对 URL 响应的影响 -- 设置合理的超时值 - -### 调试技巧 -- 遇到问题时总是启用 `debug=True` -- 检查控制台输出的详细诊断信息 -- 使用时间信息识别慢的组件 -- 报告问题时分享调试日志 - -## 支持 - -- **问题反馈**：通过 GitHub Issues 报告错误，附带调试日志 -- **功能请求**：通过 GitHub Discussions 提交 -- **文档**：查看 README.md 了解英文版本 -- **调试帮助**：启用调试模式并分享控制台输出 - ---- - -❤️ 为 ComfyUI 社区而构建 - -**支持的模型：** -- `gemini-2.5-flash-image-preview`：通过OpenAI兼容接口调用Gemini模型，支持图像处理和文本生成 -- 自动适配OpenAI SDK调用方式，无需额外配置 - -### 自动检测 -或者，只需定义带后缀的密钥： -```bash -OPENAI_API_KEY_provider1=key1 -OPENAI_API_KEY_provider2=key2 -``` -系统会自动检测并填充提供商下拉菜单。 - -## 节点参数 - -### 图片节点 (`flexai:openai_image`) - -| 参数 | 类型 | 描述 | -|------|------|------| -| `provider` | 选择 | API 提供商选择 | -| `model` | 字符串 | 模型名称 (如 `dall-e-3`) | -| `prompt` | 字符串 | 生成/编辑提示词 | -| `image_1-4` | 图片 | 可选图片（提供任意张则进入编辑模式） | -| `size` | 字符串 | 输出尺寸 (如 `1024x1024`) | -| `debug` | 布尔 | 启用调试日志 | - -### 文本节点 (`flexai:openai_text`) - -| 参数 | 类型 | 描述 | -|------|------|------| -| `provider` | 选择 | API 提供商选择 | -| `model` | 字符串 | 模型名称 (如 `gpt-4o`) | -| `system_prompt` | 字符串 | 系统消息 | -| `user_prompt` | 字符串 | 用户消息 | -| `image_1-4` | 图片 | 可选参考图片 | -| `max_tokens` | 整数 | 最大响应令牌数 | -| `temperature` | 浮点 | 采样温度 (0.0-1.0) | -| `stream` | 布尔 | 启用流式模式 | -| `debug` | 布尔 | 启用调试日志 | - -## 高级用法 - -### 响应格式兼容性 - -**自动格式检测：** -- **Base64 响应**：直接处理 b64_json、b64、base64 或 data 字段 -- **URL 响应**：当 API 返回图片 URL 时自动下载并转换 -- **智能回退**：无缝处理不同 API 提供商的格式差异 - -**增强错误处理：** -- 详细的响应数据类型验证 -- 网络超时和重试机制 -- 调试模式下的全面诊断信息 - -### 调试模式 - -启用增强调试模式 (`debug=True`) 获取详细信息： -- **API 请求**：发送到 API 的完整 JSON 参数 -- **API 响应**：来自 API 的完整 JSON 响应（流式和非流式） -- **图片处理**：URL 下载进度和 base64 转换详情 -- **错误诊断**：详细错误信息和建议解决方案 - -### 图片处理模式 - -**纯生成：** -- 不连接任何图片 -- 使用 `images.generate` 端点 -- 适合文本到图片生成 - -**单图编辑：** -- 连接一张图片到 `image_1` -- 使用 `images.edit` 端点 -- 适合风格转换、修改 - -**多图编辑：** -- 连接 2-4 张图片到 `image_1`, `image_2` 等 -- 所有图片作为数组发送到 `images.edit` -- 适合复杂场景编辑 - -### 多提供商使用 - -**配置多个来源：** -- 在 `.env` 文件中定义多个提供商 -- 每个节点可以独立选择API来源 -- 支持OpenAI、Anthropic、自定义端点等 - -**切换提供商：** -- 无需重启ComfyUI -- 实时切换不同模型和服务 -- 保持工作流兼容性 - -### 错误处理 - -插件包含强大的错误处理： -- 安全系统拒绝时显示有用指导 -- 调试模式下显示网络错误 -- 失败操作生成错误可视化图片 -- 非阻塞：即使失败工作流也会继续 - -### 流式文本 - -启用流式获得实时文本生成： -- 在文本节点中设置 `stream=True` -- 接收增量令牌更新 -- 支持时包含使用统计 -- 长文本生成的更好用户体验 - -## 技术细节 - -### 架构 -- **现代 SDK**：基于 OpenAI Python SDK 1.x 构建 -- **多提供商支持**：灵活配置多个API来源，支持OpenAI兼容端点 -- **Nano-Banana集成**：原生支持Gemini-2.5-Flash-Image-Preview等模型 -- **清晰结构**：使用 `flexai:` 前缀的统一命名空间 -- **模块化设计**：独立的图片和文本处理 - -### 文件结构 -``` -Comfyui-flexai/ -├── __init__.py # 插件注册 -├── provider_config.py # 多提供商管理 -├── nodes/ -│ ├── flexai/ -│ │ ├── openai_image.py # 图片生成/编辑节点 -│ │ └── openai_text.py # 文本生成节点 -│ └── utils/ -│ ├── openai_standard.py # OpenAI API 工具 -│ └── images.py # 图片处理工具 -├── test/ -│ └── test_plugin.py # 插件测试 -├── requirements.txt # Python 依赖 -└── README.md # 说明文件 -``` - -### 兼容性 - -- **ComfyUI**：任何支持自定义节点的最新版本 -- **Python**：3.8+ (使用 3.10+ 测试) -- **OpenAI SDK**：1.0+ (优先) 支持 0.x 回退 -- **APIs**：任何 OpenAI 兼容端点，包括 Nano-Banana (Gemini-2.5-Flash-Image-Preview) -- **提供商**：OpenAI、Anthropic、自定义端点等 - -## 故障排除 - -### 常见问题 - -**插件无法加载：** -- 检查 `requirements.txt` 安装 -- 验证 `.env` 文件配置 -- 完全重启 ComfyUI - -**API 错误：** -- 启用 `debug=True` 获得详细日志 -- 验证 API 密钥和端点 -- 查看提供商特定文档 - -**图片处理问题：** -- 确保图片是有效的 ComfyUI 张量 -- 检查图片格式兼容性 -- 验证模型支持图片处理 - -**安全拒绝：** -- 查看 OpenAI 使用策略 -- 修改提示词内容 -- 尝试不同模型变体 - -### 调试模式 - -启用调试模式 (`debug=True`) 获得详细日志： -- API 请求/响应详情 -- 图片处理步骤 -- 错误堆栈跟踪 -- 性能指标 - -## 测试 - -运行测试套件： -```bash -python -m test.test_plugin -``` - -这会验证： -- 插件加载 -- 提供商配置 -- 节点注册 -- 基本功能 - -## 贡献 - -1. Fork 仓库 -2. 创建功能分支 -3. 进行更改 -4. 添加测试（如适用） -5. 提交 Pull Request - -## 许可证 - -MIT 许可证 - 详见 LICENSE 文件。 - -## 支持 - -- **问题报告**：通过 GitHub Issues 报告 bug，请附带调试日志 -- **功能请求**：通过 GitHub Discussions 提交 -- **文档**：查看 README.md 英文版本 -- **调试帮助**：启用调试模式并分享控制台输出 - -## 更新历史 - -### v1.0.0 (2024-09-02) -- API响应调试增强和None数据安全检查 -- 调试功能改进，修复中文字体显示问题 -- 高级超时控制和进度模拟 -- URL响应支持和完整调试日志 -- 多提供商配置支持 -- 双模式图像处理的首个稳定版本 - --- 为 ComfyUI 社区用 ❤️ 构建 diff --git a/README.md b/README.md index 4cf26cf..c79fdaf 100644 --- a/README.md +++ b/README.md @@ -8,44 +8,32 @@ English | [中文 / Chinese](README-zh.md) A modern, unified ComfyUI plugin for OpenAI-compatible APIs with enhanced debugging and dual-mode image processing capabilities. +I wrote this plugin mainly to simplify my own workflow, allowing access to LLM or image generation through standardized OpenAI interfaces. Recently, I've been mainly using this node to play with Gemini-2.5-Flash-Image generation (haven't tested the official Gemini interface, I'm connecting to an OpenAI-compatible endpoint), and the results are quite good. + +## Recent Updates +- 2025-9-2 v1.0 release, tested integration with [tuzi](https://api.tu-zi.com/) and [GB](https://github.com/snailyp/gemini-balance) works perfectly +- 2025-8-31 Plugin initialization + ## ✨ Key Features ### 🌐 Multiple API Sources Support -- **Flexible Configuration**: Support multiple API providers via `.env` file +- **Flexible Configuration**: Support multiple API providers via `.env` file, so if you have multiple token channels you don't have to switch back and forth, they can be shared. - **Dynamic Selection**: Switch between providers without restarting ComfyUI -- **Auto-Detection**: System automatically detects and populates provider dropdown -- **Wide Compatibility**: OpenAI, Anthropic, custom endpoints, and more ### 🖼️ OpenAI Image Node (`flexai:openai_image`) - +![](thumb/flexai-image-node.jpg) **Dual-Mode Operation:** - **Edit Mode**: Provide 1-4 images → Uses `images.edit` API - **Generate Mode**: No images → Uses `images.generate` API -**Enhanced Features:** -- **Smart Response Handling**: Supports both base64 and URL responses -- **Auto Image Download**: Downloads and converts URL responses automatically -- **Enhanced Debug Mode**: Detailed request/response logging with timing -- **English Error Display**: Clear error messages without font issues -- **Comprehensive Error Handling**: Safety rejection guidance and visual feedback - ### 💬 OpenAI Text Node (`flexai:openai_text`) - +![](thumb/flexai-text-node.jpg) **Multimodal Text Generation:** -- Pure text or vision-language understanding (VQA) +- Pure text or vision-language understanding - Support 1-4 reference images with auto-scaling - Streaming and non-streaming modes - **Debug Mode**: Complete JSON logging for all operations -### 🔧 Enhanced Debugging System - -**New Debug Features:** -- **Detailed Timing**: Precise timing for each processing stage -- **Network Monitoring**: HTTP request/response tracking -- **Progress Indicators**: Visual feedback during long operations -- **Error Analysis**: Smart error categorization with solutions -- **English Error Images**: All error displays use English to avoid font issues - ## Quick Start ### Installation @@ -120,143 +108,6 @@ OPENAI_API_BASE_custom=https://your-api.example.com/v1 | `stream` | Boolean | Enable streaming mode | | `debug` | Boolean | **Enable detailed debug logging** | -## Debug Mode Features - -Enable debug mode (`debug=True`) for comprehensive logging: - -### 🔍 API Request/Response Tracking -``` -============================================================ -[DEBUG] 🚀 开始图片生成请求 -[DEBUG] ⏰ 请求时间: 2024-09-01 14:30:25 -[DEBUG] 📝 提交到OpenAI Images API的原生JSON数据: -{ - "model": "dall-e-3", - "prompt": "A cute cat", - "size": "1024x1024", - "response_format": "b64_json" -} -============================================================ -[DEBUG] 📡 正在发送API请求... -[DEBUG] 💡 生成时间通常在10-60秒之间，请耐心等待... -``` - -### ⏱️ Detailed Timing Analysis -``` -[DEBUG] 🎉 图片生成流程完成! -[DEBUG] ⏱️ 总耗时: 23.45 秒 -[DEBUG] ├─ API调用: 22.10 秒 -[DEBUG] └─ 数据解码: 1.35 秒 -``` - -### 🌐 Network Download Monitoring -``` -[DEBUG] 🌐 开始下载图片 -[DEBUG] 📡 发送HTTP GET请求... -[DEBUG] ✅ 下载成功! -[DEBUG] ⏱️ 下载耗时: 3.24 秒 -[DEBUG] 📏 下载数据大小: 1,234,567 字节 (1.2 MB) -[DEBUG] 🖼️ 检测到PNG格式图片 -``` - -### 🚨 Smart Error Analysis -- **API Configuration Issues**: Automatic detection and solutions -- **Network Problems**: Detailed connection diagnostics -- **Model Compatibility**: Supported model recommendations -- **Safety Rejections**: Content policy guidance - -## Troubleshooting Guide - -### Common Issues & Solutions - -| Error Type | Symptoms | Solution | -|------------|----------|----------| -| **API Key Problem** | "API key not configured" | Check `.env` file configuration | -| **Network Issues** | "Unable to connect" | Check internet connection/proxy | -| **Unsupported Model** | "not supported model" | Use `dall-e-3` or `dall-e-2` | -| **Safety Rejection** | "safety system rejected" | Modify prompt content | -| **Timeout** | Long wait times | Increase timeout or check API status | - -### Debug Mode Benefits -1. **Performance Analysis**: Identify bottlenecks in processing -2. **Network Diagnostics**: Track download speeds and failures -3. **Error Diagnosis**: Get specific error types and solutions -4. **API Monitoring**: See exact requests and responses -5. **Progress Tracking**: Understand processing stages - -## Technical Details - -### Enhanced Error Handling -- **English Error Images**: All error messages display in English to avoid font issues -- **Smart Error Translation**: Automatic translation of common error messages -- **Multi-System Font Support**: Compatible across macOS/Linux/Windows -- **Detailed Error Context**: Timestamps and formatted error information - -### Response Format Compatibility -- **Base64 Response**: Direct processing of various base64 field formats -- **URL Response**: Automatic download and conversion -- **Smart Fallback**: Seamless handling across different API providers -- **Format Detection**: Automatic PNG/JPEG format identification - -### Architecture -- **Modern SDK**: Built on OpenAI Python SDK 1.x -- **Multi-Provider Support**: Flexible API source configuration -- **Clean Structure**: Unified `flexai:` namespace -- **Modular Design**: Separate image and text processing utilities - -### File Structure -``` -Comfyui-flexai/ -├── __init__.py # Plugin registration -├── provider_config.py # Multi-provider management -├── nodes/ -│ ├── flexai/ -│ │ ├── openai_image.py # Enhanced image node with debug -│ │ └── openai_text.py # Enhanced text node with debug -│ └── utils/ -│ ├── openai_standard.py # API utilities with logging -│ └── images.py # Image processing utilities -├── requirements.txt # Dependencies -└── README.md # Documentation -``` - -## Best Practices - -### For Image Generation -- Use `dall-e-3` for highest quality (slower) -- Use `dall-e-2` for faster generation -- Enable debug mode when troubleshooting -- Keep prompts under safety policy guidelines - -### For Performance -- Monitor debug logs for timing bottlenecks -- Use appropriate image sizes (1024x1024 recommended) -- Consider network speed for URL-based responses -- Set reasonable timeout values - -### For Debugging -- Always enable `debug=True` when experiencing issues -- Check console output for detailed diagnostics -- Use timing information to identify slow components -- Share debug logs when reporting issues - -## Support - -- **Issues**: Report bugs via GitHub Issues with debug logs -- **Feature Requests**: Submit via GitHub Discussions -- **Documentation**: Check README-zh.md for Chinese version -- **Debug Help**: Enable debug mode and share console output - -## Update History - -### v1.0.0 (2024-09-02) -- Enhanced API response debugging and safety checks for None data -- Improved debugging features with Chinese font issue fixes -- Added advanced timeout controls and progress simulation -- Implemented URL response support with comprehensive debug logging -- Multi-provider configuration support -- Initial stable release with dual-mode image processing - --- Built with ❤️ for the ComfyUI community