Manga Translator UI 的 API Key 管理完全指南多通道轮换与限流冷却机制一次讲透【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理集成OpenAl、Gemini等多翻译引擎实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路自带可视化编辑器支持自定义文本样式一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-uiManga Translator UI 是一款开源的漫画 AI 翻译桌面工具基于 manga-image-translator 实现完整覆盖 OCR 文字检测、原文擦除、AI 翻译、图像修复与译文排版全链路并集成 OpenAI、Gemini 等多个翻译引擎。而本文聚焦它的API Key 管理能力多 API 通道轮换、failover 故障切换、429 限流冷却与不可用检测帮你彻底告别一个 Key 被限流就全线卡死的窘境 为什么多 Key 管理这么重要批量翻译几十话漫画时单一 API Key 很容易遇到两类问题临时限流429请求太快触发 rate limit任务被迫中断长期失效Key 过期、配额用尽、余额不足通道彻底不可用。Manga Translator UI 为此内置了多通道 API 轮询机制同一提供商可以配置最多多个 Key请求失败时自动按策略切换下一个通道被限流的通道会进入临时冷却冷却结束后自动重新参与候选。这套机制的代码入口在 api_key_rotation.py候选解析逻辑在 runtime_api_resolver.py。添加多 API 通道界面配置步骤打开侧边栏的「API 管理」页面选择对应功能页签翻译 / 文字识别 / 上色 / 渲染。页面只显示当前功能实际用到的 API 分组无关通道不会干扰你 默认展示3 个 API 通道。通道 1 沿用原变量名OPENAI_API_KEY/OPENAI_MODEL/OPENAI_API_BASE从通道 2 开始带数字后缀_2、_3……点击「 添加 API 通道」可继续扩展界面上限 10 个通道每个通道可单独填写 key、model、base。拖拽排序按住卡片标题左侧的移动图标调整顺序故障切换会立即按新顺序生效。官方对该行为的完整设计说明见 API_KEY_ROTATION_REVIEW.md通道与策略的详细文档见 slots-and-rotation.md界面实现位于 env_management.py。两种轮换策略怎么选每个功能组翻译 OpenAI、OCR Gemini 等 8 组都有独立的轮询策略通过.env中的策略键保存例如OPENAI_API_ROTATION_STRATEGY策略行为适用场景failover按顺序故障切换每次请求都从第一个可用通道开始失败才切下一个下一次请求重新从第一个开始主力 Key 备用 Key 的典型配置round_robin轮询每次请求轮流从不同可用通道开始冷却/不可用通道自动跳过多个 Key 额度相当想均匀分摊请求 简单记想让第一个 Key 优先用选failover想让流量平摊到所有 Key 选round_robin。限流冷却与不可用检测错误是怎么被处理的这是机制里最精妙的部分。系统把失败分成三类处理方式完全不同429 / rate limit / too many requests → 临时冷却该通道被临时跳过不视为永久失效。若响应头带Retry-After则按其指定秒数冷却否则默认冷却60 秒上限 600 秒。冷却到期后通道自动回归候选池。400 / 402 / 404 / quota / billing → 标记不可用Key 无效、配额用尽、模型不存在等长期问题会直接标记通道不可用不浪费重试次数立即切下一个 Key。修正配置后可点击「恢复 API 通道」清除状态。普通失败 / 空内容 → 当前 Key 内重试先在当前 Key 上按重试次数重试耗尽后才切换通道。左侧边栏底部会实时显示API 状态#1 可用、#2 失败、#3 不可用、#4 冷却测试按钮和运行时共用同一套状态定时刷新让你随时掌握每个通道的健康状况 重试次数 × 通道数最坏情况有多少次请求注意**「重试次数」与「通道轮换」是两层独立机制**重试在单个 Key 内部生效。以attempts2即每个 Key 最多 1 次首发 2 次重试 3 次、3 个 Key、failover 策略为例key1 连续 3 次失败 → 切 key2 → key2 再 3 次 → 切 key3最坏情况产生3 个 Key × 3 次 9 次实际 API 调用空 Key 不参与候选、不消耗调用400/402/404/quota 类错误立即跳过重试直接切 Keyattempts-1表示当前 Key 无限重试此时不会因为重试耗尽而自动切 Key。核心调度逻辑run_with_api_candidates()在 api_key_rotation.py#L380-L462先在候选内按 attempts 重试并指数退避失败后记录状态、按策略取下一候选全部耗尽才抛出APIRotationExhaustedError。实用建议与验证方式主力 备用组合通道 1 放额度充足的 Key通道 2/3 放备用策略选 failover日常最省心。多 Key 平摊3 个同级别 Key 都健康时round_robin 能显著降低单 Key 触发 429 的概率。启动前校验任务启动前的 API Key 校验已支持识别_2/_3通道——只填第二个 Key 也算已配置。预设可保存轮换配置API 预设会连同全部通道与轮询策略一起保存/恢复多套配置随意切换。用「测试当前页」按钮验证至少一个候选可连通结果弹窗会给出共 N 个可用 X 个的汇总。结语Manga Translator UI 的 API Key 管理把「多 Key 容灾」做成了零代码的界面操作通道即拖即用、冷却自动恢复、状态一目了然。配合其自带的可视化编辑器与一键部署体验无论是单 Key 用户还是多 Key 重度用户都能让漫画翻译流水线稳定跑起来。相关行为定义可进一步查阅 API_KEY_ROTATION_REVIEW.md 与 failures-cooldown-and-recovery.md源码入口在 api_key_rotation.py 【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理集成OpenAl、Gemini等多翻译引擎实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路自带可视化编辑器支持自定义文本样式一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考