先确认出错的功能和位置
第三方服务报错时，先记下在哪个网站、哪个页面、做什么操作时失败，再检查对应服务的设置。连接失败、认证失败、超时和结果未保存，需要分别排查。
涉及后台配置时，请使用有相应管理权限的账号。检查服务器网络和日志，则需要网站维护人员协助。不要把“权限不足”直接当成第三方密钥错误。
翻译失败时，先核对实际使用的服务
在后台对应的服务设置中，核对“翻译厂家”和“AI设置”。设置里的多语言一键填充始终使用所选翻译厂家；后台“翻译文章”是否使用 AI，由文章翻译的 AI 开关决定。
- 使用翻译厂家：核对所选厂家，以及该厂家要求的密钥、区域等配置。不要只修改 AI 密钥。
- 使用 AI：在“AI设置”中核对当前 AI 通道的密钥、地址和模型。不同通道分别保存配置，要检查本次实际选中的通道。
- 配置不完整：当前 AI 调用要求密钥、地址和模型都不为空。填了密钥但遗漏地址或模型，仍无法调用。
- AI 翻译失败：默认直接提示错误，不会自动改用翻译厂家。不要把翻译厂家已配置好当成 AI 失败后的自动保障。
按失败阶段检查
| 现象 | 检查内容 |
|---|---|
| 连接不上 | 核对服务地址、协议和端口。请维护人员从实际发起请求的服务器检查网络、域名解析和证书情况。 |
| 认证失败或请求被拒绝 | 核对凭据是否属于当前账户和服务，是否已失效，以及服务商要求的产品权限、环境和白名单。 |
| 参数错误 | 按业务核对模型名称、模板、语言代码、货币或回调参数。记录服务商返回的状态码和提示，不要只反复替换密钥。 |
| 额度或频率受限 | 到对应服务商账户检查余额、调用额度和频率限制。服务商余额与网站用户余额不是同一项。 |
| 请求超时 | 记录等待时长，请维护人员区分连接超时、服务处理过慢和服务器中间环节超时。 |
| 返回结果但页面未更新 | 检查结果是否保存到预期内容和语言，以及是否被已有内容的覆盖或跳过策略影响。 |
| 支付回调未到达 | 检查回调地址能否从公网访问、是否对应正确的网站，以及签名校验和订单处理结果。回调是支付服务向网站通知处理结果的请求。 |
浏览器能打开服务商网站，不代表运行 PHP 或 Node 的服务器也能连接。Node 是运行瓜奇前端服务的环境；应由维护人员检查实际发起请求的一端。
当前后台 AI 调用的连接超时为 30 秒，总请求超时为 120 秒。这是该调用的代码设置，不代表所有第三方服务都采用相同时间，也不保证页面一定会等待满 120 秒。
普通 localhost 地址不能直接接收服务商的公网回调。支付后跳回成功页，也不能单独证明网站已确认到账。
修改后怎样验证
- 保存对应设置，重新打开，确认修改已保留且选中了正确的服务或通道。
- 使用同一网站、同一页面语言和同一账号，重复一次最小范围的操作，例如只翻译一篇文章。
- 检查实际结果：翻译是否写入正确的目标文章，批量任务是否有失败或跳过项；支付问题则核对对应订单的状态和处理结果。
- 如果仍失败，记录操作时间、等待时长和完整公开提示，交给维护人员对照服务端记录。
支付请求超时后，先核对已有订单和付款记录，再决定是否重试，避免重复付款。
报错语言和反馈范围
经过 Node 统一错误处理的提示会按请求的页面语言转换。不能再把下载功能一概视为只显示中文，也不能据此保证后台提示、第三方页面或所有异常都会自动显示英文。
反馈时提供目标网站、页面语言、业务类型、操作时间、内容或订单 ID，以及脱敏后的状态码和错误提示。通用失败提示本身不足以确定根因，还需要维护人员检查相关记录。
不要公开密钥、密码、完整回调签名、客户资料或内部错误堆栈。需要日志时，只提供与本次失败有关的脱敏片段。