
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 允许的情况下,可以逐步降低请求间隔,但不建议一次调整过大。