Luna Translator 接入

难度 🧩 中等　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以 控制台 实际为准

LunaTranslator 是一款开源的 GalGame / 视觉小说翻译器，支持通过 HOOK 提取文本、OCR 识别，并接入大模型做 AI 翻译。把它接到半页酥 API，就能用 gpt-5.5、claude-opus-4-8 等模型实时翻译游戏文本。

开始之前

先到 控制台 → 令牌 创建一个 API 令牌（形如 sk-xxxx）。创建时务必选对分组，分组决定了你能调用哪些模型与计费方式，详见 选择分组。

第 1 步：下载并安装 Luna Translator

前往 LunaTranslator 官方文档 下载最新版，解压后运行主程序即可（Windows 免安装绿色版）。

第 2 步：配置大模型接口

LunaTranslator 提供「一键导入」与「手动配置」两种方式，推荐先试方式一。

方式一（最快）：从控制台一键导入

1. 在 半页酥控制台 打开 系统设置 → 聊天设置，添加如下聊天跳转链接：

聊天设置链接

{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }

2. 进入 控制台 → 令牌（Token）管理，找到你的令牌，点击「聊天」右侧的下拉箭头，选择 LunaTranslator，浏览器会自动唤起客户端并写入配置。
3. 在 LunaTranslator 中打开 设置 → 翻译设置 → 大模型，找到刚刚自动新增的那条接口配置。
4. 点击模型下拉框旁的「刷新」按钮，从半页酥拉取可用模型列表，选择一个（如 gpt-5.5）并保存。
5. 打开该接口配置左侧的启用开关。

方式二：手动配置

1. 在 控制台 → 令牌管理 复制你的 API Key（sk-xxxx）。
2. 在 LunaTranslator 中打开 设置 → 翻译设置 → 大模型，点击「添加」。
3. 复制一份 「大模型通用接口」 模板。
4. 在新接口的字段中填入以下内容：

字段	填写值
API 接口地址 / base_url	https://byesu.com/v1
API Key	sk-xxxx（你的令牌）
模型 model	gpt-5.5（或下一步刷新后选择）

5. 点击模型框旁的「刷新」，从下拉列表里选择要用的模型。

地址不要漏 /v1

LunaTranslator 走的是 OpenAI 兼容接口，base_url 必须是 https://byesu.com/v1（结尾带 /v1）。若填成 https://byesu.com 会导致接口无法识别。

第 3 步：启用并验证

1. 打开该接口配置左侧的启用开关。
2. 回到主界面，在翻译引擎里勾选这条大模型接口作为译文来源。
3. HOOK 或 OCR 抓取一段游戏文本，确认能正常返回中文译文即接入成功。

常用模型参考：

• 速度优先、性价比高：gpt-5.5
• 翻译质量更细腻：claude-opus-4-8
• 长文本 / 多语种：gemini-3.1-pro-high

卡住了？

• 报 401 / 鉴权失败：API Key 填错或带了多余空格，请重新从令牌管理复制 sk-xxxx。见 常见错误 #auth。
• 提示无可用渠道 / 模型不存在：当前令牌分组下没有该模型，换个模型或调整分组。见 选择分组 与 常见错误 #no-channel。
• 额度不足 / 余额为 0：令牌配额用尽，请充值或检查令牌额度上限。见 常见错误 #balance。
• 刷新模型列表为空：确认 base_url 结尾是 /v1，且令牌有效。

更多排查见 常见错误。