# ComfyUI-TranslateGemma：将Google多语言翻译模型集成到AI绘画工作流

> ComfyUI-TranslateGemma是一个将Google开源的TranslateGemma翻译模型集成到ComfyUI的节点插件，支持55种语言互译、图像文字翻译，并提供多种模型规格和量化选项以适应不同硬件配置。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-13T09:16:35.000Z
- 最近活动: 2026-06-13T09:21:21.072Z
- 热度: 150.9
- 关键词: ComfyUI, TranslateGemma, Gemma, AI绘画, 翻译模型, 多语言, 开源项目, ComfyUI插件
- 页面链接: https://www.zingnex.cn/forum/thread/comfyui-translategemma-googleai
- Canonical: https://www.zingnex.cn/forum/thread/comfyui-translategemma-googleai
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：rookiestar28
- 来源平台：github
- 原始标题：ComfyUI-TranslateGemma
- 原始链接：https://github.com/rookiestar28/ComfyUI-TranslateGemma
- 来源发布时间/更新时间：2026-06-13T09:16:35Z

## 原作者与来源\n\n- 原作者/维护者：rookiestar28\n- 来源平台：GitHub\n- 原始标题：ComfyUI-TranslateGemma\n- 原始链接：https://github.com/rookiestar28/ComfyUI-TranslateGemma\n- 来源发布时间/更新时间：2026-06-13T09:16:35Z\n\n## 项目概述\n\nComfyUI-TranslateGemma是一个将Google TranslateGemma翻译模型集成到ComfyUI的节点插件。TranslateGemma是基于Gemma 3构建的开源翻译模型家族，支持55种语言的文本互译，以及独特的多模态图像文字翻译功能。\n\n对于使用ComfyUI进行AI绘画创作的用户来说，这个插件解决了跨语言提示词（prompt）处理的痛点。用户可以直接在ComfyUI工作流中完成从中文到英文（或其他语言）的自动翻译，无需在多个工具之间切换。\n\n## TranslateGemma模型背景\n\nTranslateGemma是Google于2025年发布的开源翻译模型，基于Gemma 3架构训练而成。与商业翻译API不同，TranslateGemma可以完全本地运行，保护用户隐私的同时提供高质量的翻译服务。\n\n模型提供三种规格以适应不同的硬件配置：\n\n- **4B版本**：轻量级模型，适合显存有限的设备，翻译质量依然可观\n- **12B版本**：平衡性能与资源消耗，适合大多数消费级显卡\n- **27B版本**：完整规格模型，提供最佳翻译质量，需要较大显存\n\n## ComfyUI集成特性\n\n### 核心功能\n\n该ComfyUI节点提供了丰富的功能选项：\n\n**多语言文本翻译**：支持55种语言之间的互译，覆盖全球主要语种。用户可以在节点中直接输入源文本，选择目标语言，即可获得翻译结果。\n\n**图像文字翻译**：独特的多模态能力允许模型识别并翻译图像中的文字。这对于处理带有文字元素的AI生成图像特别有用，比如海报设计、漫画翻译等场景。\n\n**自动语言检测**：节点支持自动检测输入文本的语言，用户无需手动指定源语言。\n\n### 2026年1月更新亮点\n\n项目近期发布了重要更新，增加了多项实用功能：\n\n**中文简繁转换专用模式**：新增`chinese_conversion_only`选项，通过OpenCC实现简繁体中文的快速转换，无需加载完整的翻译模型，节省显存和时间。\n\n**智能token预算**：支持将`max_new_tokens`和`max_input_tokens`设为0来自动计算token预算，系统会根据上下文智能分配资源。\n\n**长文本处理策略**：新增`long_text_strategy`参数，提供三种处理模式：\n- `disable`：禁用长文本特殊处理\n- `auto-continue`：自动继续生成，避免长文本被截断\n- `segmented`：分段处理，适合超长文档\n\n**设备管理**：支持`device`参数覆盖，可以指定`cpu`、默认GPU或具体的`gpu:N`设备，与ComfyUI的设备管理策略保持一致。\n\n**BitsAndBytes量化**：可选的8bit或4bit量化支持，在CUDA环境下可以显著降低显存占用，让大模型在消费级显卡上也能流畅运行。\n\n## 安装与配置\n\n### 安装方式\n\n**通过ComfyUI-Manager安装**（推荐）：\n\n1. 打开ComfyUI-Manager界面\n2. 搜索"TranslateGemma"\n3. 点击安装并重启ComfyUI\n\n**手动安装**：\n\n```bash\ncd ComfyUI/custom_nodes\ngit clone https://github.com/rookiestar28/ComfyUI-TranslateGemma.git\ncd ComfyUI-TranslateGemma\npip install -r requirements.txt\n```\n\n如需使用量化功能，额外安装：\n```bash\npip install -r requirements-quantization.txt\n```\n\n### Hugging Face授权\n\nTranslateGemma模型采用Gemma许可证，属于受控（gated）模型。使用前需要：\n\n1. 访问Hugging Face上的模型页面（translategemma-4b-it、12b-it或27b-it）\n2. 接受Gemma使用条款\n3. 通过`huggingface-cli login`登录，或设置`HF_TOKEN`环境变量\n\n### 模型存储位置\n\n模型文件默认存储在：\n- `ComfyUI/models/LLM/TranslateGemma/<模型名称>/`\n\n对于网络受限的环境，可以手动下载模型文件并放置到上述目录，节点会自动识别本地缓存。\n\n## 使用场景与技巧\n\n### AI绘画提示词翻译\n\n最常见的使用场景是将中文提示词翻译为英文，以便在ComfyUI中使用。例如：\n\n输入："一位穿着汉服的少女在樱花树下"\n输出："A young girl wearing Hanfu under cherry blossom trees"\n\n### 图像文字识别与翻译\n\n当需要翻译图像中的文字时，需要同时提供图像输入和源语言指定。模型会将图像中的文字内容提取并翻译为目标语言。\n\n### 中文简繁快速转换\n\n对于只需要在简体中文和繁体中文之间转换的场景，启用`chinese_conversion_only`模式可以跳过模型加载，直接使用OpenCC进行转换，速度更快且不占显存。\n\n### 性能优化建议\n\n- **显存不足时**：选择4B模型或启用4bit量化\n- **追求质量时**：使用27B模型，确保显存充足\n- **批量处理时**：考虑使用`segmented`长文本策略\n- **网络受限环境**：提前下载模型到本地\n\n## 故障排查\n\n**下载失败**：如果遇到模型下载问题，可以尝试：\n- 设置`HTTP_PROXY`/`HTTPS_PROXY`代理\n- 使用社区镜像（设置`HF_ENDPOINT`环境变量）\n- 手动下载模型文件\n\n**401/403错误**：表示未通过Gemma授权，需要先在Hugging Face接受使用条款并配置token。\n\n**显存不足**：尝试更小的模型规格或启用量化。\n\n## 项目意义\n\nComfyUI-TranslateGemma的出现填补了ComfyUI生态系统中高质量本地翻译能力的空白。在此之前，用户通常需要依赖在线翻译API，这不仅涉及网络延迟和隐私问题，还可能因为API限制影响工作流稳定性。\n\n通过将Google的开源翻译模型无缝集成到ComfyUI，这个插件让用户可以在完全离线的环境下完成从提示词翻译到图像生成的完整流程，对于注重隐私或处于网络受限环境的用户尤其有价值。\n\n## 总结\n\nComfyUI-TranslateGemma是一个实用且功能丰富的ComfyUI插件，它将Google TranslateGemma强大的多语言翻译能力带入了AI绘画工作流。无论是处理提示词翻译、图像文字识别，还是简单的简繁转换，这个插件都能提供流畅的本地解决方案。对于ComfyUI用户来说，这是一个值得尝试的工具。