翻译云API批量翻译保留变量符
使用翻译云API的“文本占位符”功能，在翻译请求中预定义变量符格式，引擎将自动识别并保护这些占位符，仅翻译纯文本内容，从而解决变量被误译或丢失的问题。
1 获取并配置API鉴权Token
登录翻译云控制台，点击左侧导航栏【API管理】->【我的密钥】，复制您的SecretId和SecretKey。在您的脚本或应用中，使用这两个参数生成请求签名，具体算法请参考API文档。
2 封装异步并发请求并设置占位符
在调用翻译接口（如/v2/translate）时，于请求体（Body）的JSON参数中，设置"placeholderFormat": "\\{\\$.*?\\}"。此正则表达式将匹配并保护所有{$variable}格式的变量。同时，为提升大批量文件处理效率，需封装异步请求逻辑。
在请求 Header 中加入 `X-Fanyiyun-Priority: high` 提升队列优先级，并使用异步 Webhook 接收回调避免超时。
3 配置Webhook接收并处理回调结果
在翻译云控制台，进入【Webhook配置】页面，填写您的回调URL。在提交翻译任务时，请求参数中需指定"callbackUrl": "您的URL"。翻译完成后，系统将向该URL POST发送结果，您需在服务端编写接口解析JSON，提取translatedText字段，其中变量符已被完整保留。
常见操作避坑指南
Q：占位符正则表达式设置后，变量仍被翻译或丢失，如何处理？
A：请检查正则表达式是否正确转义。在JSON中，反斜杠
\需双重转义，例如匹配{$name}应写为"\\{\\$name\\}"。建议先在控制台的【体验中心】使用相同参数测试单条文本，确认匹配成功后再进行批量调用。Q：高并发批量请求时触发频率限流，或回调超时未收到结果？
A：首先，确保已在请求头中加入
X-Fanyiyun-Priority: high。其次，检查您的回调服务（Webhook）接口性能，确保能在3秒内返回HTTP 200状态码，避免因响应超时被翻译云判定为投递失败。可考虑使用消息队列异步处理回调数据。⚠️ 技术规范与免责声明：本文档提供的配置指令与操作步骤基于翻译云当前最新版本。受限于源文档的加密级别、扫描件分辨率及第三方软件（如 InDesign/WPS）的底层排版逻辑差异，最终翻译与排版还原效果可能存在合理波动。涉及机密合同与财务数据的处理，请务必在工作台中开启「阅后即焚」或使用企业级私有化部署方案。
