From 32107a72fd3ea91d357350c4e0eca041df38b54e Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 21 May 2025 17:27:51 +0000 Subject: [PATCH] Translate README.md to English This commit translates the README.md file from Chinese to English. The translation includes all sections of the README, preserving technical details, formatting, and contact information. The translated README has been reviewed for clarity, grammar, and accuracy to ensure it is easily understandable for an English-speaking audience. --- README.md | 152 +++++++++++++++++++++++++++--------------------------- 1 file changed, 76 insertions(+), 76 deletions(-) diff --git a/README.md b/README.md index 1544f42..40af4d4 100644 --- a/README.md +++ b/README.md @@ -1,121 +1,121 @@ -# ComfyUI Gemini Flash 节点 +# ComfyUI Gemini Flash Node -这是一个用于ComfyUI的Google Gemini API集成节点，支持文本生成和图像生成功能。通过此节点，您可以在ComfyUI工作流中直接使用Google的Gemini 2.0系列模型。 -特别说明：关于出现[ERROR]API调用错误:'NoneType'object has no attribute'parts 说明你上传的图片或者提示词已经违反了《Generative AI Prohibited Use Policy》，请先使用场景或者产品图测试。 +This is a Google Gemini API integration node for ComfyUI, supporting text generation and image generation functions. With this node, you can directly use Google's Gemini 2.0 series models in your ComfyUI workflow. +Special Note: Regarding the error [ERROR]API call error: 'NoneType' object has no attribute 'parts', it means that the image or prompt you uploaded violates the "Generative AI Prohibited Use Policy". Please test with general scene or product images first to ensure compliance. ![](https://github.com/tatookan/comfyui_ssl_gemini_EXP/blob/main/demo/demo.png?raw=true) --- ![](https://github.com/tatookan/comfyui_ssl_gemini_EXP/blob/main/demo/demo2.png?raw=true) -## 更新 -2025.3.19：更新支持多图处理功能 -## 功能特点 +## Updates +2024.3.19: Updated to support multi-image processing. +## Features -- 支持Gemini 2.0系列模型（gemini-2.0-flash, gemini-2.0-flash-exp, gemini-2.0-pro） -- 支持文本到文本生成 -- 支持图像到文本生成（图像理解） -- 支持文本到图像生成（仅在其他.py文件中实现） -- 内置代理支持，方便中国用户使用 -- 自动依赖检查和安装 -- 完善的错误处理和日志记录 +- Supports Gemini 2.0 series models (gemini-2.0-flash, gemini-2.0-flash-exp, gemini-2.0-pro) +- Supports text-to-text generation +- Supports image-to-text generation (image understanding) +- Supports text-to-image generation (Note: this functionality is implemented in separate .py files, not directly within this node.) +- Built-in proxy support for convenient use by users in China +- Automatic dependency checking and installation +- Comprehensive error handling and logging -## 安装方法 +## Installation Method -1. 确保您已经安装了ComfyUI -2. 将此仓库克隆或下载到ComfyUI的`custom_nodes`目录中： +1. Ensure you have ComfyUI installed. +2. Clone or download this repository into ComfyUI's `custom_nodes` directory: ``` cd ComfyUI/custom_nodes git clone https://github.com/tatookan/comfyui_ssl_gemini_EXP.git ``` -3. 安装依赖： +3. Install dependencies: ``` cd comfyui_ssl_gemini_EXP pip install -r requirements.txt ``` -4. 重启ComfyUI +4. Restart ComfyUI. -## 使用方法 +## How to Use -### 1. 配置API密钥 +### 1. Configure API Key -首先，您需要获取Google Gemini API密钥： -1. 访问[Google AI Studio](https://makersuite.google.com/app/apikey) -2. 创建一个API密钥 -3. 在ComfyUI中使用`💠SSL/API/Gemini/API Key Config`节点输入您的API密钥 +First, you need to obtain a Google Gemini API key: +1. Visit [Google AI Studio](https://makersuite.google.com/app/apikey) +2. Create an API key +3. In ComfyUI, locate and use the `💠SSL/API/Gemini/API Key Config` node to enter your API key. -### 2. 文本生成 +### 2. Text Generation -使用`💠SSL/API/Gemini/Text Prompt`节点进行文本生成： +Use the `💠SSL/API/Gemini/Text Prompt` node for text generation: -- 连接API密钥配置节点到`config`输入 -- 在`prompt`中输入您的提示文本 -- 调整生成参数（温度、top_p、top_k等） -- 如果需要，可以连接图像到`input_image`输入，实现图像理解功能 +- Connect the API key configuration node to the `config` input. +- Enter your prompt text in `prompt`. +- Adjust generation parameters (temperature, top_p, top_k, etc.). +- If needed, connect an image to the `input_image` input for image understanding. -### 3. 代理设置 +### 3. Proxy Settings -如果您在中国或其他需要代理的地区： +If you are in China or other regions requiring a proxy: -1. 将`use_proxy`设置为`True` -2. 设置`proxy_host`（默认为127.0.0.1） -3. 设置`proxy_port`（默认为7890） +1. Set `use_proxy` to `True`. +2. Set `proxy_host` (default is 127.0.0.1). +3. Set `proxy_port` (default is 7890). -## 参数说明 +## Parameter Description -### API密钥配置节点 +### API Key Configuration Node -- `api_key`: Google Gemini API密钥 +- `api_key`: Google Gemini API key -### 文本生成节点 +### Text Generation Node -#### 必填参数 +#### Required Parameters -- `config`: API密钥配置 -- `prompt`: 提示文本 -- `model`: 选择模型（gemini-2.0-flash, gemini-2.0-flash-exp, gemini-2.0-pro） -- `temperature`: 生成温度（0.0-1.0），控制创意程度 -- `top_p`: 核采样参数（0.0-1.0） -- `top_k`: 考虑的候选词数量（1-100） -- `max_output_tokens`: 最大输出标记数（1-8192） -- `include_images`: 是否在响应中包含图像（True/False） +- `config`: API key configuration +- `prompt`: Prompt text +- `model`: Select model (gemini-2.0-flash, gemini-2.0-flash-exp, gemini-2.0-pro) +- `temperature`: Generation temperature (0.0-1.0), controls the randomness and creativity of the output. +- `top_p`: Nucleus sampling parameter (0.0-1.0) +- `top_k`: Number of candidate tokens to consider (1-100). Higher values mean more diversity. +- `max_output_tokens`: Maximum output tokens (1-8192) +- `include_images`: Whether to include images in the response (True/False) -#### 可选参数 +#### Optional Parameters -- `input_image`: 输入图像（用于图像理解） -- `use_proxy`: 是否使用代理（True/False） -- `proxy_host`: 代理主机地址 -- `proxy_port`: 代理端口 +- `input_image`: Input image (for image understanding) +- `use_proxy`: Whether to use a proxy (True/False) +- `proxy_host`: Proxy host address +- `proxy_port`: Proxy port -## 输出 +## Output -文本生成节点输出： -- `text`: 生成的文本 -- `image`: 如果启用了图像生成，则输出图像 +Text generation node output: +- `text`: Generated text +- `image`: If image generation is enabled, outputs the image. -## 注意事项 --根据谷歌的《Generative AI Prohibited Use Policy》，Gemini API 有以下限制： --不得用于生成违反法律法规的内容 --不得用于生成有害、欺诈、色情或暴力内容 --不得用于生成侵犯他人隐私或知识产权的内容 --图像生成可能受到额外限制，某些类型的图像可能无法生成 +## Precautions/Notes +- According to Google's "Generative AI Prohibited Use Policy", Gemini API has the following restrictions: +- Must not be used to generate content that violates laws and regulations. +- Must not be used to generate harmful, fraudulent, pornographic, or violent content. +- Must not be used to generate content that infringes on others' privacy or intellectual property rights. +- Image generation may have additional restrictions, and certain types of images might not be generatable. -- 使用此节点需要稳定的网络连接或有效的代理设置 -- API请求可能会受到Google服务器负载的影响 -- 大型请求可能需要更长的处理时间 -- 图像生成功能需要使用支持图像生成的模型（如gemini-2.0-flash-exp） +- Using this node requires a stable network connection or effective proxy settings. +- API requests may be affected by Google server load. +- Large requests may require longer processing times. +- The image generation feature requires a model that explicitly supports it (e.g., `gemini-2.0-flash-exp`). -## 故障排除 +## Troubleshooting -- 如果遇到网络连接问题，请检查代理设置 -- 如果API请求失败，请检查API密钥是否有效 -- 如果依赖安装失败，请手动安装所需的依赖包 +- If you encounter network connection problems, please check your proxy settings. +- If API requests fail, please check if your API key is valid. +- If dependency installation fails, please manually install the required dependency packages. -## 致谢 +## Acknowledgements -感谢Google提供的Gemini API服务。 +Thanks to Google for providing the Gemini API service. # Contact Details Email: dianyuanan@vip.qq.com -加入我的粉丝群: 联系微信: Miss-Y-s-Honey, 并注明来意 -查看我的教程频道 [bilibili@深深蓝hana](https://space.bilibili.com/618554?spm_id_from=333.1007.0.0) -日常作品分享 [douyin@深深蓝](https://www.douyin.com/user/MS4wLjABAAAAJGu7yCfV3XwKoklBX62bivvat3micLxemdDT0FAmdcGfqbuFS3ItsKWKrBt5Hg16?from_tab_name=) +Join my fan group: Contact WeChat: Miss-Y-s-Honey (please state your purpose when adding). +Check out my tutorial channel [bilibili@深深蓝hana](https://space.bilibili.com/618554?spm_id_from=333.1007.0.0) (Channel name is in Chinese: 深深蓝hana) +Daily work sharing [douyin@深深蓝](https://www.douyin.com/user/MS4wLjABAAAAJGu7yCfV3XwKoklBX62bivvat3micLxemdDT0FAmdcGfqbuFS3ItsKWKrBt5Hg16?from_tab_name=) (Profile name is in Chinese: 深深蓝)