沉浸式翻译配置 deepseek api 教程

沉浸式翻译的免费通道翻长文经常卡顿或降质，不少人想换成自己申请的 API 走量。真动手时又容易卡在填哪几个字段、模型名写什么、报错了不知道是哪一步错。这篇按顺序给一份配置清单和排查路径，照着做基本能通，不通也知道先去哪看。

沉浸式翻译自带的免费通道，翻短句还行，一遇到长文就容易卡顿，质量也会掉。不少人想换成自己申请的 API 走量，思路没错，但真动手时问题一堆：密钥填哪、接口地址写什么、模型名是不是随便写一个就行。这篇按配置顺序走一遍，照着做基本能通，不通也知道先去哪一步看。

先说明适用范围：下面这套是给「自己一个人用、偶尔翻网页和文档」的场景写的。如果是团队多人共用一份密钥，额度和限流管控的责任划分完全不一样，得先想清楚谁付钱、超了谁负责，再谈配置。另外文里提到的价格、模型清单这类会变的信息，一律不写死，你到站内页面看当时的数字。

动手前先备齐三样东西

配置失败的人，八成是密钥还没准备好就打开插件了。先去 DeepSeek 官方平台注册账号并生成一枚 API Key，生成后页面只显示一次，当场复制存到自己的密码管理器里，关掉就找不回来了。至于当前有哪些模型可选、按什么口径计费，别信旧教程，直接到 DeepSeek 官方价格与规格页面核对当期信息。

接口地址

插件把请求发去哪台服务器，官方文档给什么就填什么，自己加减斜杠会直接连不上

模型名

你要调用的那个模型在平台上的实际名称，写错的表现是能保存但一翻就报错

密钥

证明是你本人在用额度的凭证，等同于密码，别贴进任何截图或公开仓库

第三样东西是用途范围。只给自己偶尔翻网页，和团队多人共用一份密钥，额度消耗速度、要不要设限额完全是两回事。个人用一般不用额外管控，团队共用则要先想好超额之后谁负责，否则月底账单出来容易扯皮。

插件里那几个字段怎么填

打开沉浸式翻译的翻译服务设置，选「自定义」或列表里对应的 API 服务项。三个框的顺序别搞反：密钥框粘密钥，接口地址框按官方文档给的接入点原样抄，模型名框填平台实际在售的名称。这三项任一写错都连不上，但报错信息不一样，后面排查那节会讲怎么区分。

1. 填密钥把刚才存好的那串粘进密钥框，前后不要带空格，粘完自己看一眼末尾有没有多余字符。
2. 填接口地址对着官方文档逐字符抄，尤其注意结尾有没有斜杠，多一个少一个都可能报路径错误。
3. 填模型名只填模型名称本身，不要带前缀路径或别的修饰，填完先保存不急着测。
4. 跑一次短测保存后拿一段几百字的短文试翻，通过再上长文档。

高级项里的并发数和每次请求字数，别一上来就拉满。先按默认值跑通一次，确认能正常返回结果，再按你常翻的文档长度逐步调高。并发拉太高，短时间大量请求容易触发平台的限流，表现是前几段正常、后面突然全失败，这种最难查。

怎么算配通了，通了之后调什么

判断标准很简单：选一段几百字的中英文短文，翻出来结果通顺、没有报错弹窗，就算配通了。别一上来就丢整篇 PDF 进去，出问题时你根本分不清是配置错、密钥失效还是长度超限，变量太多。

如果你同时挂了多个翻译服务做对比，注意只有当前选中的那一个在生效。切换服务之后要重新点一次测试，别拿上一个服务的结果判断新配置，这是很多人误判「配好了」的原因。什么时候这套不适用？如果你需要多人协作、统一术语库，那已经超出插件自带配置能解决的范畴，得考虑更专业的方案。

连不上按这个顺序排

报错之后别乱点，按下面这个顺序从外到内查，能省掉大部分瞎折腾的时间。核心原则是：先排除账号和额度层面的问题，再查地址和模型名，最后才怀疑网络和插件本身。

• 第一步看密钥和额度：密钥失效、余额不足、账号被限流，表现都是请求被拒，这类问题你换地址换模型都没用
• 第二步看接口地址和模型名：这两项之一写错，通常报的是找不到模型或路径错误，把两个字段逐字符对一遍官方文档
• 第三步看网络与延迟：到站内接口测速页面量一下本机到该接入点的延迟基线，延迟高到超时，表现也是翻译失败
• 第四步才怀疑插件本身：更新版本、换个浏览器、关掉其他同类扩展再复测，用来区分是配置问题还是环境冲突

按这个顺序查，多数问题到第二步就能定位。如果四步都过了还是不通，把完整的报错信息复制下来，连同你填的接口地址和模型名（密钥别贴）一起带去问，比一上来就发「用不了」效率高得多。

配置类问题，先分清是账号层面、参数层面还是环境层面，方向对了，剩下只是对字符。