沉浸式翻译自定义 API 国内接入清单：地址、Key、模型怎么填，怎样控制翻译成本
沉浸式翻译通过 OpenAI 服务配置接入不墨 API 时，“自定义 URL 地址”填 https://api.bumo.cc/v1/chat/completions，Key 填不墨密钥，自定义模型填完整 ID。 不墨标准 Base URL 为 https://api.bumo.cc/v1，但这里需要的是包含请求路径的完整地址。用户操作分三步：准备 Key 与余额 → 填好三个配置项 → 翻译一小段并核对用量。
2026 年 10 月 16 日已核对不墨公开模型列表、入口页面与沉浸式翻译官方文档。本次未进行有效 Key 的翻译请求，也未测量译文质量、速度、单篇费用或付款过程；本文是配置与验收清单。
清单一：确认走的是 OpenAI 兼容入口
在扩展设置中选择 OpenAI 翻译服务，再配置自己的 API。官方其他 AI 模型临时接入给出了这种接法，字段包括 api_key、自定义模型、自定义 URL 地址，示例地址包含 /v1/chat/completions。
不要误选名称相近的自定义接口翻译：那是另一种请求与响应约定，需要服务端按该约定返回翻译结果，不能仅把 OpenAI 聊天地址粘进去就认为协议一致。
配置前核对：
不墨 API 余额与沉浸式翻译自身的会员额度分别管理。本文只覆盖自带 Key 的接入，不承诺扩展内所有付费功能都因此解锁。
清单二：把三个字段配成同一套
下面这组配置以普通文本翻译为起点：
| 配置项 | 填写内容 |
|---|---|
| 翻译服务 | OpenAI |
| API Key / api_key | 你在不墨创建的 Key |
| 自定义 URL 地址 | https://api.bumo.cc/v1/chat/completions |
| 自定义模型 | qwen/qwen3.8-flash |
字段可能随扩展版本移动位置，以当前版本的设置页为准。本例按官方“自定义 URL 地址”字段填写完整端点，不要在这格只留域名或 /v1，也不要填钱包页地址。
Key 与 URL 要一起核对。如果自定义 URL 仍指向原来的服务商，即使换了不墨 Key，也不会变成不墨调用。模型名同样必须来自不墨的当前模型列表，保留完整前缀。
清单三：先从低标价候选试起，再比较译文
本次模型列表中，qwen/qwen3.8-flash 与 glm/glm-5.3-flash 的普通输入、输出标价处于较低一组，可作为短文试译的候选；deepseek/deepseek-flash 也在列表中，可以用同一段原文作对照。这只是基于当前价目字段选择测试起点，不是翻译能力排名，也不是每篇文章的费用承诺。
选便宜模型不能只看名字带不带 Flash。先用一个模型翻译你常看的短文本；若人名、术语、否定句等出现问题，再换一个候选比较。不必一开始同时配齐所有模型。
| 检查项 | 怎样比较才有意义 |
|---|---|
| 原文 | 用同一段文字，长度和内容保持一致 |
| 译文 | 核对数字、单位、术语、否定关系及漏译 |
| 实际用量 | 每次试译后查看钱包记录，避免其他客户端同时调用干扰判断 |
| 决策 | 保留质量达到自己要求、实际成本可接受的那一个 |
输入内容、提示词和输出译文都会影响用量；网页拆成多段、重复翻译或失败重试，也可能增加请求。不能把“一页网页”当成固定价格单位。当前单价请从不墨页面查看，实际扣费以钱包记录为准。
清单四：只用一段短文完成首次验收
先打开不含敏感信息的短文章，仅翻译一个短段落。下面是你可以自行使用的测试原文，不是本次已经跑过的案例：
The meeting starts at 9:30 on Friday. Please do not share the draft before approval.
验收时看三件事：是否显示了中文译文；星期、时间和“审批前不要分享”的意思是否保留；钱包是否出现与此次调用相符的用量。前两项通过后，再试一段带你所在行业术语的内容。
如果只需要理解其中一段，就先停在这一段。不要为了“测通没有”直接翻译整本电子书或长篇 PDF。短文通过也不代表文档排版、图片识别等其他功能已验证。
清单五：出现错误，按现象缩小范围
| 现象 | 排查动作 |
|---|---|
| 401 / Invalid API key | 检查 Key 是否完整，URL 是否仍指向不墨 |
| 404 | 核对完整路径是 /v1/chat/completions，没有遗漏或重复 |
| 找不到模型 | 重新打开模型列表，逐字检查自定义模型 ID |
| 429 | 看错误详情，降低扩展请求频率，停止反复批量重试 |
| 余额不足 | 查看不墨钱包，而非扩展自身会员剩余额度 |
| 请求成功但译文不合要求 | 核对目标语言和提示词，再用同一小样本比较另一个模型 |
沉浸式翻译 OpenAI 文档也建议遇到频率限制时降低请求数；其中针对 OpenAI 的示例价格与限额不适用于不墨，不能直接拿来估算这份配置的成本。
先保持默认翻译提示词，避免首次配置同时改地址、模型、提示词和并发。遇到问题时一次只改一个因素，才能知道是哪项生效。
完成后再扩大翻译范围
能翻出一段短文并核对用量后，再逐步增加到自己实际需要的文章长度。看到公开模型列表，只验证了目录可读；必须由你的有效 Key 完成请求，才算自己的接入通过。
准备开始时，打开不墨 API Key 页面，按清单二填入扩展，然后完成一次短文验收。