LunaTranslator 接入 Models Hub:配置大模型翻译接口
在 LunaTranslator 里新增大模型接口并指向 Models Hub,填入 API 地址与密钥后视觉小说翻译走 Models Hub 额度,附推荐模型与常见报错排查。
LunaTranslator 是一款开源免费的视觉小说(GalGame)翻译器,通过 HOOK 提取游戏文本并支持多种翻译引擎。它内置「大模型通用接口」,可以接入任何 OpenAI 兼容的翻译服务,把接口指向 Models Hub 后,游戏文本翻译会用 Models Hub 的额度调用你指定的模型。本文只讲接入,LunaTranslator 的 HOOK、OCR 等功能见官方文档。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1、一个模型名。
准备
- 已安装 LunaTranslator。下载安装见官方文档 - 下载 & 启动 & 更新。项目地址:GitHub。
- 一个 Models Hub API Key。在控制台的 令牌页 创建,令牌所在分组要能访问你打算用的模型。
推荐模型
游戏文本翻译请求频繁、量大,模型选择直接影响成本,优先选便宜快速的模型;想要更贴合语境和角色语气,再切成更强的模型。
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常游戏翻译首选,速度快 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
| 便宜快速,备选项 | claude-haiku-4-5 | 查看价格 | 可用率与延迟 |
| 长句、复杂语境追求更贴合 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
方式一:令牌页一键跳转(如可用)
部分 Models Hub 站点在 令牌页 的令牌旁提供跳转 LunaTranslator 的快捷选项,点击后会跳转到 LunaTranslator 并自动填入 API 地址与 Key。这个入口是否出现取决于站点后台开关,以你当前令牌页的实际界面为准;没有就用下面的手动配置。
方式二:手动配置
-
在 LunaTranslator 中依次打开 设置 → 翻译设置 → 大模型,点击「添加」。
-
复制「大模型通用接口」模板,新增一个接口。
-
在新增的接口里填写:
字段 填什么 API 地址 https://modelsok.com/v1API Key 你的 Models Hub API Key 
-
点击 model 下拉框旁的刷新按钮拉取模型列表,选择或直接输入上面推荐的模型名,点击确定保存。
-
确认新增接口旁的开关按钮已打开,未启用则点击启用。
验证
启用后在游戏中触发一次 HOOK 翻译或点击「测试翻译」,能看到中文译文即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 翻译结果为空或报接口错误 | API 地址填错,常见是漏了 /v1 | 改成 https://modelsok.com/v1 |
提示密钥无效 / 401 | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新复制 |
| model 下拉框刷新不出模型 | 网络无法访问接口地址,或 Key 无效 | 先确认地址与 Key 填对,再点刷新 |
| 提示模型不存在 | 手动输入的模型名拼错,或令牌所在分组没有该模型 | 对照 定价页 核对拼写 |
| 配置好了但游戏里没用上 | 新增接口旁的开关没打开 | 点击开关启用该接口 |
更多排查见 故障排查,或查看 LunaTranslator 官方文档 - 大模型翻译接口。
常见问题
计费方式? 按每次翻译请求实际消耗的输入与输出 token 计费,价格看各模型定价页。游戏文本通常较短,单句成本很低。
和直接用 OpenAI 官方接口有什么区别? 填的字段完全一样,只是把 API 地址换成了 Models Hub,不需要自己申请 OpenAI 账号。
怎么换模型? 回到该接口的编辑界面,点 model 下拉框刷新后重新选择,或直接改成表格里的其它模型名。