本文手把手教你获取DeepSeek API Key，在沉浸式翻译中配置接口、模型与术语库，并排查常见报错，实现网页、PDF和字幕的双语翻译。
把DeepSeek接入沉浸式翻译，核心是让沉浸式翻译调用DeepSeek的OpenAI兼容接口完成翻译任务。相比传统机翻，DeepSeek对中文语境、长句逻辑和专业术语的处理更自然，尤其适合技术文档、论文、新闻和产品手册。下面以桌面浏览器扩展版为例展开，Edge、Chrome、Firefox的设置路径基本一致，移动端可参考相同字段。
1. 获取DeepSeek API密钥与接口信息
第一步是进入DeepSeek开放平台注册账号并完成实名或企业认证，然后在控制台左侧找到API Keys入口，点击创建新的API Key。创建时可以给密钥起一个便于识别的名称，例如“沉浸式翻译专用”，确认后系统只会完整显示一次以sk-开头的密钥字符串。这个字符串就是后续要填入沉浸式翻译的凭证，必须立即复制到密码管理器或本地加密笔记中。如果页面关闭后忘记保存，只能删除旧密钥并重新创建，平台不会再次展示完整内容。同时要在账户余额页面确认可用余额，DeepSeek API按输入和输出token计费，余额不足时翻译请求会直接失败。
接口信息方面，DeepSeek兼容OpenAI格式，基础地址可以填写，完整对话端点对应。模型名称建议使用deepseek-chat，它对应通用对话模型，响应速度和翻译质量比较均衡，适合网页段落、PDF长文和字幕短句。deepseek-reasoner更适合复杂推理，输出中可能包含思维链内容，延迟也更高，不建议在沉浸式翻译里作为默认翻译模型。如果使用第三方中转服务，必须确认其兼容OpenAI的chat/completions协议，并核对模型名是否被映射为deepseek-chat。
准备工作还包括安装沉浸式翻译扩展。在Chrome应用商店、Edge加载项或Firefox附加组件中搜索“沉浸式翻译”，安装后把图标固定到工具栏，并登录账号以便同步站点规则、术语库和部分偏好设置。需要提醒的是，API Key属于敏感凭证，不要截图发到公开群组，也不要在共享电脑的浏览器里长期保存。若团队多人共用，建议在DeepSeek平台按成员分别创建密钥，便于出现异常时单独吊销。
2. 在沉浸式翻译中添加DeepSeek翻译服务
打开沉浸式翻译的设置页，可以从扩展图标右键选择“选项”，也可以在浏览器扩展管理页面进入扩展详情后点击“扩展选项”。在左侧菜单找到“翻译服务”或“翻译服务管理”，点击“添加翻译服务”。新版沉浸式翻译通常已经内置DeepSeek选项，直接在服务列表里选择DeepSeek，把刚才复制的API Key粘贴进去，模型选择deepseek-chat，保存后点击“测试服务”。如果测试返回翻译结果，说明密钥、余额和网络都正常，随后把它设为默认翻译服务即可。
如果当前版本没有内置DeepSeek，就选择OpenAI或OpenAI Compatible这类自定义服务。名称可以填“DeepSeek”，API地址填；如果界面要求填写完整请求地址，则填。模型名严格填写deepseek-chat，不要多写空格或大小写混用。高级参数里，温度可以设为0.3到0.7之间，翻译任务通常不需要太高随机性；最大输出token根据网页段落长度设置，过长会浪费额度，过短可能截断译文；流式输出建议开启，能更快看到逐段结果。自定义提示词可以写成“你是专业翻译，只输出译文，保留Markdown、代码块、变量名和链接格式”，这样能减少模型附加解释。
保存后要做两件事。一是回到翻译服务列表，把DeepSeek设为默认，并检查“始终翻译”“从不翻译”的站点规则是否与默认服务冲突。二是打开一篇外文网页，点击扩展图标选择“翻译”，观察双语对照是否正常。如果译文出现大段解释、原文重复或格式错乱，优先检查自定义提示词和温度参数，而不是反复更换密钥。对于技术文档，建议在提示词中强调保留代码、命令、API路径和专有名词，避免DeepSeek把关键字段翻译成中文。
3. 网页、PDF与字幕场景的实战配置
网页翻译是最常用的场景。打开外文新闻、官方文档或GitHub页面后，点击沉浸式翻译图标，选择“翻译此页”，页面会以段落为单位插入译文，形成双语对照。如果希望某些站点自动翻译，可以在设置中加入“始终翻译”规则，例如docs.deepseek.com或arxiv.org；如果内部系统或银行页面不应翻译，则加入“从不翻译”。阅读长文时可以使用鼠标悬停翻译，只翻译光标所在段落，减少token消耗。遇到动态加载页面，滚动后新内容可能需要重新触发翻译，部分版本支持自动翻译动态内容，可在设置中开启。
PDF翻译需要在沉浸式翻译的PDF功能中操作。文本型PDF可以直接把文件拖入浏览器，或在扩展的PDF翻译入口上传，选择DeepSeek作为翻译服务，随后生成左右对照或上下对照版本。扫描版PDF本质是图片，扩展通常无法直接提取文字，需要先用OCR工具转成可复制文本，再交给沉浸式翻译处理。电子书EPUB也可通过类似导入，按章节拆分翻译，避免一次性发送过长内容导致超时。对于论文，建议提前在术语库中添加专业词汇，例如模型名、算法名和机构名，保持全文译名一致。
字幕翻译适合YouTube、Coursera等视频页面。打开视频后启用沉浸式翻译的字幕功能，选择DeepSeek服务，设置双语字幕或仅译文字幕。字幕句子短、数量多，容易触发并发限制，建议把并发数降到1到2，并开启缓存。术语库在设置中的“术语库”页面维护，可以逐条添加原文和译文，也可以导入CSV文件。对于同一项目，把产品名、角色名、技术名词提前录入，能显著减少DeepSeek每次重新判断译法的情况。若视频字幕时间轴错位，先关闭其他字幕扩展，再检查沉浸式翻译的字幕样式和延迟设置。
4. 报错排查、成本控制与安全边界
常见报错里，401通常表示API Key错误或已被删除，需要回到DeepSeek平台重新创建并粘贴；402表示余额不足，要检查账户余额和是否超出限额；429表示请求频率过高，降低沉浸式翻译的并发数、关闭自动翻译全部页面，或稍后再试；400多与模型名、请求地址或参数格式有关，重点核对deepseek-chat拼写和；超时则可能是网络波动或DeepSeek服务临时繁忙，可以切换网络、关闭代理，或把默认服务临时切到备用翻译。排查时先点“测试服务”，再打开浏览器开发者工具查看网络请求状态码，比盲目重装扩展更有效。
成本控制要围绕token用量展开。日常翻译优先用deepseek-chat，不要用deepseek-reasoner处理普通网页；开启翻译缓存，同一页面重复打开时尽量复用结果；对长文档使用按需翻译或鼠标悬停翻译，而不是整站自动翻译；把不常看的站点加入“从不翻译”，把高频站点加入“始终翻译”并配合缓存。DeepSeek的计费按输入和输出token分别计算，缓存命中通常有折扣，具体价格以官方定价页为准。若发现某天用量异常，可以在平台查看API调用记录，确认是否被其他应用或脚本共用同一密钥。
安全边界同样重要。使用云端API意味着网页文本、PDF内容或字幕会发送到DeepSeek服务器，涉及合同、个人信息、未公开代码或内部文档时，应改用本地翻译模型或先做脱敏处理。API Key不要写进公开仓库、前端代码或共享文档，浏览器扩展中保存的密钥要确保设备本身有锁屏和账号保护。定期在DeepSeek平台轮换密钥，删除不再使用的旧密钥；当密钥在平台侧被删除或轮换后，沉浸式翻译中的旧配置会立即失效，需要重新填写新的密钥并再次测试服务。
