第三方翻译API接入失败的排查应该按照“密钥本身→账户权限→额度余额→网络环境→平台限制”的顺序逐步推进。先在API平台后台确认密钥状态和账户订阅正常，再检查月度免费额度是否已用完，然后排查网络环境是否满足该API的使用要求，最后确认是否存在DeepL免费版密钥在SaleSmartly中的平台限制等特定兼容性问题。通过分步骤的系统化排查和对比测试，大多数接入失败问题都可以定位到具体原因并找到对应的解决方法。建议在排查过程中记录每一步的测试结果，避免重复尝试相同的无效操作。
检查API密钥的完整性和正确性
确认密钥没有多余的空格或缺失字符
API密钥是由大小写字母和数字组成的字符串，在从API平台后台复制到SaleSmartly配置页面时，最容易出现的错误是复制时多复制了一个空格、遗漏了末尾的字符或复制了不完整的密钥。用户应该先在纯文本编辑器（如记事本）中粘贴一次密钥，检查字符串的完整性，确认长度与API平台显示的一致，然后再复制到SaleSmartly中。如果密钥中包含特殊字符，粘贴时也要确保这些字符被完整保留。
确认复制的是正确的API密钥而非其他凭证
不同的翻译API平台会生成多种不同类型的凭证，用户可能不小心复制了其他类型的信息。DeepL后台会生成API密钥字符串，百度翻译后台会生成App ID和密钥两个不同的凭证，SaleSmartly中需要分别填入对应的输入框。用户需要仔细确认自己复制的是API密钥而非账户ID、项目ID或其他标识符。如果填入的是错误类型的凭证，系统验证时会直接失败。
检查API密钥是否已过期或被停用
登录对应的API平台后台，检查当前使用的API密钥的状态。DeepL用户登录DeepL官网后台，在API管理页面查看密钥是否仍然显示为有效状态。百度翻译用户登录百度智能云控制台，在应用管理页面查看密钥的状态标识。如果密钥显示为已过期、已停用或已删除，需要重新生成新的API密钥并更新到SaleSmartly中。
检查API平台账户的权限和订阅状态
DeepL账户订阅状态是否正常
DeepL API的有效性与账户的订阅状态直接相关。用户登录DeepL后台检查账户的订阅计划是否处于有效期内，如果订阅已过期或自动续费失败，API密钥会失效。DeepL免费版API密钥虽然不收费，但同样需要账户处于正常状态才能工作。如果DeepL账户因为违规使用或异常活动被暂停，所有API密钥都会无法调用。
百度翻译API服务是否已开通
百度翻译用户在实名认证通过后，还需要在百度智能云控制台中手动开通机器翻译服务，才能使用API。用户应该在百度智能云控制台中确认机器翻译服务是否已显示为已开通状态，且对应的API版本（标准版或高级版）与自己在SaleSmartly中配置的版本一致。如果服务未开通，需要先点击开通服务按钮完成开通操作。
Google Cloud结算功能是否正常
Google Translate API的用户需要检查Google Cloud项目的结算功能是否正常。如果绑定的信用卡过期或支付失败，Google Cloud会暂停项目结算，所有API调用都会失败。用户登录Google Cloud Console检查结算状态，确认账户没有欠费且支付方式有效。如果结算被暂停，需要更新支付信息并重新启用结算才能恢复API调用。
检查API平台的免费额度是否已用完
DeepL月度50万字符额度已用完
DeepL API每月提供50万字符免费额度，如果当月翻译量已达到上限，继续调用DeepL API会返回额度不足的错误。用户需要登录DeepL后台查看当月的字符消耗统计，确认是否已经达到50万字符的月度限额。如果额度已用完，可以选择等待下月重置、切换到其他翻译引擎或升级到DeepL付费计划继续使用。
百度翻译免费调用量已耗尽
百度翻译标准版API每月提供一定额度的免费调用量，具体额度需要登录百度翻译开放平台查看当前政策。用户进入百度智能云控制台的用量统计页面，查看当月的API调用次数和字符消耗情况。如果当月免费调用量已经用完，继续调用百度翻译API会失败。此时可以等待下月重置，或者购买额外的调用量，也可以切换到其他翻译引擎。
Google Cloud免费试用额度已用完
Google Translate API的新用户免费试用额度用完后，如果结算账户没有余额或未升级到付费计划，API调用会被拒绝。用户查看Google Cloud Console的账单页面确认免费试用额度是否已经耗尽。如果已经用完且希望继续使用Google翻译，需要升级到付费计划并确保账户中有足够的余额。
检查网络环境是否满足API使用要求
百度翻译API在国内可直接使用
百度翻译API在国内网络环境下可以直接调用，不需要特殊的网络配置。如果百度翻译API接入失败且报错信息指向网络问题，用户应先检查电脑的网络连接是否正常，确认能够正常访问百度翻译开放平台官网。如果网络正常但API调用仍然失败，问题可能在其他环节而非网络。
DeepL API在某些地区可能访问受限
DeepL在中国的访问稳定性总体上优于Google，但在某些地区或特定网络环境下可能会出现访问速度较慢或连接不稳定的情况。如果DeepL API接入失败且报错为超时或连接失败，用户可以在网络环境相对稳定的时段重试。如果持续失败且排除密钥和配额问题，可以尝试更换网络环境后重新测试。
Google Translate API需要外网环境
Google Translate API的调用需要SaleSmartly服务器能够访问Google服务，如果服务器所在网络无法访问Google，翻译请求会失败。用户需要确认自己的网络环境是否能够访问Google Cloud Platform服务。如果需要使用Google Translate API且当前网络环境受限，考虑使用其他不需要外网的翻译API作为替代方案。
检查平台特定限制和兼容性问题
DeepL免费版密钥在SaleSmartly中的限制
DeepL已经限制了SaleSmartly服务器IP地址使用免费版（以:fx结尾）密钥。如果用户尝试在SaleSmartly中使用DeepL免费版API密钥，可能会遇到“翻译工具安装失败”或密钥验证失败的提示。用户可以将该API密钥放到第三方翻译服务中测试，如果在第三方中验证通过但在SaleSmartly中不通过，说明DeepL确实限制了免费密钥在该平台的使用。解决方案是升级到DeepL付费版API密钥。
百度翻译API服务版本匹配问题
用户在百度智能云控制台开通机器翻译服务时可以选择标准版或高级版，不同版本的服务调用方式和额度和接口地址可能有所不同。用户需要在SaleSmartly的百度翻译配置中确认所选的服务版本与实际开通的版本一致。如果版本不匹配，API调用可能会因为接口地址或参数格式不对而失败。
API密钥绑定的项目或应用限制
部分API平台允许用户在生成API密钥时设置调用限制，例如只允许特定IP地址、特定域名或特定项目调用该密钥。用户需要登录API平台后台检查密钥的权限设置，确认SaleSmartly的调用请求没有被密钥本身的限制策略拒绝。如果密钥设置了IP白名单，需要将SaleSmartly服务器的IP地址添加到白名单中。
常见问题FAQ
接入失败时如何快速判断是密钥问题还是网络问题？
通过对比测试。将相同的API密钥在第三方翻译工具中测试，如果第三方能正常翻译而SaleSmartly中失败，通常是SaleSmartly端的配置或平台限制问题。如果第三方也无法使用，则是密钥本身或API平台的问题。
接入失败的报错信息怎么看？
SaleSmartly在API验证失败时通常会返回具体的错误提示，例如“密钥无效”“连接超时”“额度不足”“权限不足”等。用户应仔细阅读报错信息中的关键词，根据错误类型定位问题方向，而不是只看“接入失败”几个字。
多个API同时接入失败是什么原因？
如果所有绑定的API都同时接入失败，大概率是SaleSmartly系统或账户层面出了问题。检查网络连接是否正常、确认账户状态是否正常、查看系统是否有维护公告。如果单引擎失败则是该引擎自身问题。