跳到正文

GaaaiTranslator 百度翻译开放平台 API 配置教程

GaaaiTranslator 支持接入百度翻译开放平台,通过百度翻译 API 自动处理 WordPress 文章、评论、标签和分类。

百度翻译开放平台配置相对简单,适合个人网站、中小型内容网站以及日常增量翻译。

一、申请百度翻译开放平台账号

进入百度翻译开放平台,注册或登录百度账号。

完成个人实名认证后,可根据平台规则开通相应版本的通用文本翻译服务。

开通后,在开发者信息或应用管理页面获取:

  • AppID
  • 密钥

这两项信息需要填写到 GaaaiTranslator 后台。

二、选择百度翻译开放平台

进入:

WordPress 后台 → GaaaiTranslator → 批量翻译

在“翻译接口”中选择:

百度翻译开放平台

选择后,页面会显示对应的 AppID 和密钥填写区域。

三、填写 AppID 和密钥

将百度翻译开放平台提供的信息分别填写到:

  • 百度翻译 AppID
  • 百度翻译密钥

填写时注意不要带有多余空格。

密钥属于敏感信息,不要公开在文章、截图或前端页面中。

四、设置语言方向

例如,将中文网站翻译为英文网站,可以设置:

  • 源语言:zh
  • 目标语言:en

也可以将源语言设置为:

auto

由接口自动识别原文语言。

五、设置请求间隔

百度翻译开放平台可能对接口调用频率进行限制。

建议将“请求间隔”设置为:

300~800 毫秒

网站文章较多或接口频繁出现错误码 54003 时,可以适当增加请求间隔。

例如:

  • 普通测试:300 毫秒
  • 批量文章:500 毫秒
  • 经常限流:800~1500 毫秒

间隔越短,理论速度越快,但更容易触发接口限流。

六、设置限流退避

插件支持百度翻译开放平台 54003 限流退避。

推荐设置:

  • 限流退避重试次数:3~5 次
  • 限流退避初始时间:800 毫秒

遇到接口调用频率过高时,插件会等待后重新请求,而不是立即将内容标记为翻译失败。

七、设置接口超时时间

建议接口超时时间保持为:

25 秒

如果服务器访问百度接口速度较慢,可以增加到 30~40 秒。

不建议设置过高,否则单个异常请求可能长时间占用批量任务。

八、开始测试

保存设置后,先选择一篇短文章进行翻译。

测试时检查:

  • 是否能够正常返回翻译结果
  • 是否提示 AppID 或密钥错误
  • 是否频繁出现 54003
  • 文章排版是否完整
  • 翻译方向是否正确

接口测试正常后,再开始批量任务。

常见问题

提示 AppID 或密钥错误

检查填写内容是否完整,并确认使用的是百度翻译开放平台的 AppID 和密钥,而不是百度智能云的 AK 和 SK。

提示 54003

说明接口请求频率过高。

可增加请求间隔,并适当减少每批处理数量。

翻译速度较慢

百度翻译开放平台不同版本的并发限制不同。

在接口额度和 QPS 允许的情况下,可以逐步降低请求间隔,但不建议一次调整过大。

版权声明:本文为原创内容,转载请注明出处。