配置第三方API后，SaleSmartly的翻译功能会即时生效，用户无需重启桌面客户端、网页版或手机App，因为API密钥的绑定和翻译引擎的切换是在账户级别完成的，保存后所有设备自动同步。配置成功的关键在于第三方平台获取的API密钥本身有效，且在翻译设置中将新配置的API引擎设为默认。本地翻译线路切换因涉及客户端网络配置，需重新登录才能生效，与配置API的即时生效机制不同。了解两种操作的不同处理方式，有助于用户在不同场景下正确应对。
配置保存后翻译引擎立即切换
后台保存配置即时生效无需重启
当用户在SaleSmartly后台完成第三方API密钥的配置并点击保存后，系统会立即验证该密钥的有效性，验证通过后翻译引擎的切换即时生效。这个切换过程在后台完成，用户不需要对桌面客户端进行任何重启或重新登录操作。配置完成后，下一次在聊天窗口中点击翻译按钮或使用自动翻译功能时，系统就会调用新配置的第三方API进行翻译。用户无需关闭当前窗口、刷新页面或重新登录账户即可看到配置生效后的翻译结果，整个切换过程对客服的工作节奏不产生任何中断。
配置生效后所有翻译请求使用新通道
第三方API配置成功并设为默认翻译引擎后，系统在后续的所有翻译请求中优先调用用户录入的API Key完成翻译。用户在聊天窗口中点击翻译按钮、开启自动翻译模式或使用其他翻译触发方式时，翻译请求都会通过新配置的API通道发送，SaleSmartly平台不再扣除翻译字符数。这种变化在配置保存后即时生效，用户不需要等待系统同步或重启应用。平台翻译配额在配置成功后自动停止消耗，用户可以通过观察账户中的积分是否减少来验证配置是否生效。
配置是账户级别的不分设备独立配置
第三方API的配置是在SaleSmartly账户级别完成的，绑定后所有设备（桌面客户端、网页版、手机App）自动共享同一个API配置。用户不需要在每个设备上单独配置API密钥，也不需要重启设备上的客户端应用。配置生效后，无论在哪个设备登录SaleSmartly，翻译都会使用新配置的API通道。一个设备上的配置变更会同步到所有设备，用户在不同设备之间切换时翻译设置保持一致。
配置成功后的验证方法
在聊天窗口中直接测试翻译
配置完成后，用户可以直接在现有的聊天窗口中进行翻译测试来验证配置是否生效。选择一条客户发送的外语消息，点击翻译按钮或使用自动翻译模式，观察翻译结果是否正常返回。如果翻译功能正常工作且账户中的SaleSmartly翻译配额没有减少，说明第三方API已成功生效，当前翻译正在通过新配置的API通道完成。测试过程中不需要重启客户端或重新打开聊天窗口，直接在当前的对话中操作即可得到验证结果。
在后台查看翻译引擎状态
用户在翻译设置或AI助理设置页面中，可以看到当前已安装和启用的翻译引擎列表。配置成功后，新配置的第三方API引擎会显示为“已启用”或“已连接”状态，用户可以确认该引擎已被系统识别并可正常调用。如果引擎状态显示为“未启用”或“配置错误”，说明配置可能存在密钥无效、网络连接问题或账户状态异常等情况，需要重新检查并修复。
观察平台配额是否停止消耗
配置第三方API前，平台内置翻译的每次翻译操作都会从账户的AI助理积分或购买的字符额度中扣除对应的字符数。配置成功后，系统优先调用第三方API完成翻译，不再扣除SaleSmartly平台的翻译配额。用户在翻译测试后可以进入应用市场的翻译工具管理页面或费用中心，查看账户中的翻译余额是否有变化。如果翻译成功且余额保持不变，说明第三方API已成功接管翻译请求。
配置适用所有设备无需分别操作
桌面端配置后网页版自动同步
用户在桌面客户端或网页版中完成第三方API配置后，该配置会在账户级别保存，并自动同步到同一账户的所有设备上。如果用户在桌面客户端中配置了DeepL API，之后通过浏览器登录SaleSmartly网页版或使用手机App时，翻译功能会自动使用DeepL引擎，不需要在每个设备上重复配置API密钥。配置的跨设备同步确保用户在不同工作场景下切换设备时翻译设置保持一致。
配置保存后无需重启客户端
第三方API的配置是后台账户级别的设置变更，配置完成后不会要求用户重启桌面客户端或重新登录网页版。用户保存配置后可以立即在当前打开的聊天窗口中继续工作，翻译功能会在下一次翻译操作时自动使用新的API通道。这种即时生效的设计让客服团队在切换翻译引擎时不会因为需要重启应用而产生工作中断。
新配置不影响已打开的聊天窗口
配置第三方API后，用户已经打开的聊天窗口不需要关闭或重新打开。新配置对已打开的窗口同样生效，窗口中的翻译功能会自动使用新的API通道。已经在聊天窗口中显示的已翻译消息不受配置变更影响，只有配置完成后发起的翻译操作才会使用新通道。
配置本地翻译线路切换需要重启
本地翻译线路切换与API配置不同
在SaleSmartly桌面客户端中，本地翻译的线路切换与第三方API配置是两个完全不同的操作，处理方式也不同。本地翻译线路切换是网络故障修复操作，用于解决本地免费翻译无法连接Google服务器的问题。官方帮助文档明确指出，当用户在桌面客户端左上角切换翻译线路后，必须重新登录客户端才能使新的线路设置生效。这是因为本地翻译线路涉及客户端的本地网络配置，需要重新加载才能应用新的网络通道。
两种操作的使用场景区分
第三方API配置是账户级别的翻译引擎切换，用户在后台填写API密钥后保存即可，不需要重启客户端。本地翻译线路切换是网络层级的故障排查操作，仅在本地免费翻译因网络问题失败时使用，切换后需要重新登录客户端。用户在配置第三方API时不需要考虑线路切换的重启问题，但如果使用本地翻译遇到网络故障需要切换线路，则需要按照官方指引重新登录客户端。
配置API与线路切换操作入口不同
第三方API配置的入口在SaleSmartly后台的设置或应用市场中，是系统设置层面的操作。本地翻译线路切换的入口在桌面客户端左上角的切换线路选项中，是在客户端操作界面中的网络配置调整。两个操作的入口位置和功能目的不同，用户应根据自己的需求选择正确的操作入口和后续处理方式。
配置后无需额外操作的注意事项
确认API密钥是否有效
配置第三方API时，系统会验证密钥的有效性。如果密钥无效、已过期或被平台限制，配置可能无法成功保存或保存后无法正常调用。用户在保存配置前应确认从第三方平台获取的API密钥是有效的，DeepL免费版API密钥在SaleSmartly中已被限制使用，需要升级到付费版API密钥才能正常调用。
确认默认翻译引擎已切换
配置第三方API后，用户需要在翻译设置中确认该引擎是否已被设为默认翻译引擎。如果安装或绑定了多个翻译引擎但未将新配置的API引擎设为默认，系统可能仍然使用之前的引擎完成翻译，导致配置似乎没有生效。用户可以在翻译设置中调整引擎优先级，将新配置的API引擎拖动到列表顶部使其成为默认引擎，然后进行翻译测试验证生效情况。
检查API平台免费额度是否充足
第三方API配置成功后，翻译消耗从对应API平台的额度中扣除。如果DeepL API的月度50万字符免费额度已用完或百度翻译API的免费调用量已耗尽，翻译请求可能失败，即使配置正确也无法正常返回翻译结果。用户需要登录对应的API平台后台查看剩余额度，在额度即将用完时提前切换到其他翻译引擎或补充额度。
常见问题FAQ
配置第三方API后需要重启SaleSmartly客户端吗？
不需要。第三方API的配置在后台保存后即时生效，所有设备自动同步，无需重启客户端或重新登录。配置完成后下一次翻译操作就会使用新的API通道。
为什么切换本地翻译线路时需要重启，配置API不用？
配置第三方API是账户级别的设置变更，系统后台直接更新配置，即时生效。切换本地翻译线路是网络通道的变更，需要客户端重新加载网络配置，因此需要重新登录客户端使新线路生效。
配置后翻译仍然在消耗平台配额是什么原因？
可能配置未成功保存、API密钥无效或默认引擎未切换至配置的第三方API。可以检查翻译设置中的默认引擎是否已切换，确保密钥有效且引擎状态显示为已启用。配置成功后系统会优先调用第三方API，不再扣除平台翻译字符数。