必须通过后端代理获取access_token再调用文心AI翻译API,前端直接暴露密钥会导致403错误;需防抖、输入法兼容及并发锁控QPS,否则请求静默失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在网页中通过API接入文心AI实现即时翻译功能,必须绕过浏览器同源策略限制、正确构造带鉴权的POST请求、实时解析JSON响应并动态更新DOM,否则页面将出现403错误或空白返回。
获取合法访问凭证
登录百度千帆平台→进入「应用管理」→点击「创建应用」→填写应用名称(如“网页翻译插件”)→提交后立即获得 【API Key】 和 【Secret Key】。这两个密钥不可共享,泄露会导致账户被恶意调用。
注意:若控制台未显示「Secret Key」,说明该应用处于“待审核”状态,需完成企业实名认证才可解锁完整权限。
在前端安全获取access_token
浏览器环境禁止直接暴露Secret Key,必须通过后端中转获取access_token。你需部署一个轻量代理接口(例如Node.js的Express路由):
① 用户在网页发起翻译请求时,先向你的域名/api/get-token发送GET请求;
② 你的服务器用环境变量中存储的API Key和Secret Key,拼接URL:https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=${API_KEY}&client_secret=${SECRET_KEY};
③ 发起HTTP GET请求,捕获响应中的access_token字段;
④ 将access_token作为JSON返回给前端,有效期30天,但建议每次翻译前都刷新——因为token一旦被盗用,攻击者可无限次调用模型接口。
构造翻译请求并渲染结果
方法一:使用fetch发送标准POST请求
确保HTML中已有两个textarea元素,id分别为sourceText和targetText;
监听sourceText的input事件,延迟300ms防抖后触发翻译;
文心AI(Windows)基于文心大模型打造,适用于办公写作、内容创作与知识处理场景。最新版新增“全局AI快捷唤起”“本地文件深度解析2.0”“多任务并行Agent协作”以及“AI表格与PPT自动生成能力”,同时优化长文本理解与代码生成能力,让Windows用户可在任意软件中快速调用AI能力,实现更高效的办公与创作体验。
fetch请求地址为https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/translate,请求头必须包含Authorization: Bearer ${access_token}和Content-Type: application/json;
请求体JSON结构为:{"q": "待译文本", "from": "auto", "to": "zh"},其中to值支持en/ja/ko/fr/es等标准语言代码;
收到响应后,直接赋值给targetText.value,无需额外解析——文心翻译API返回字段固定为result.trans_result[0].dst。
方法二:用SDK简化调用(推荐)
在页面引入官方JS SDK:<script src="https://sdk.baidu.com/erniebot-js/latest/erniebot.min.js"></script>;
初始化时传入从后端获取的access_token:erniebot.init({ accessToken: 'xxx' });;
调用翻译方法:erniebot.translate({ q: text, from: 'auto', to: 'zh' }).then(res => targetText.value = res.trans_result[0].dst);;
这一步操作起来很简单,直接把SDK脚本标签加到body底部就行,但要注意SDK版本必须匹配当前千帆平台支持的API v1接口规范,旧版SDK会因签名算法不兼容而报错401。
处理中文输入与实时响应冲突
当用户用中文拼音输入法打字时,input事件会在选词未确认前就频繁触发,导致连续发请求。解决方法是在事件监听中加入判断:if (event.inputType === 'insertText' || event.inputType === 'deleteContentBackward'),只对真实字符增删动作响应;
同时设置全局锁变量let isTranslating = false,在fetch前设为true,响应完成后设为false,防止用户快速连击触发并发请求——文心API对同一token的QPS限制为5次/秒,超限请求会被直接拒绝且不返回错误码,表现为静默失败。

















