一、这个功能能做什么
瓜奇有两条容易混淆的自动翻译链路：设置字段里的「自动翻译」，以及内容编辑中的文章翻译。文章可以选择 AI 模型，设置字段的一键填充仍使用「翻译厂家」。
先认识这几个词
- API 密钥：访问某项服务的凭据，不是普通显示文字，也不一定是登录密码。
- 占位符：发送或显示时自动替换的标记，例如用站点名称或当前订单号替换。
逐项设置与效果
| 设置 | 功能与效果 |
|---|---|
| AI 通道 | 配置适用密钥、服务地址和模型，供支持的内容辅助功能使用 |
| 普通翻译服务 | 分别配置 DeepL、Google、Azure、百度、腾讯等所需凭据 |
| 整包 AI 翻译 | 为支持字段启用文章 AI 翻译流程 |
二、设置后会有什么效果
可以自动填写多语言设置文字，或翻译文章内容。设置字段使用翻译厂家，文章可启用 AI 整包翻译，两种入口处理的对象不同。
三、怎么使用
选择翻译方式
在瓜奇的第三方服务配置中找到翻译相关设置，先选择「翻译厂家」，再填写该厂家对应参数。当前代码包含 DeepL、Google、Azure、百度、腾讯云五种接口。
| 接口 | 瓜奇中需要核对的参数 |
|---|---|
| DeepL | 接口地址、密钥 |
| 翻译 API 密钥 | |
| Azure | 接口地址、密钥、区域 |
| 百度 | 翻译 AppID、密钥 |
| 腾讯云 | SecretId、SecretKey、区域 |
这些是项目对接参数，不是第三方平台开通流程。第三方账户应已具备对应服务权限；错误提示可能涉及额度、认证、语言支持或网络。不要把其他服务的同名密钥直接当作翻译服务密钥。
文章翻译使用 AI
- 在「AI 设置」选择通道，填写该通道的地址、密钥和模型。
- 开启「文章翻译使用 AI（整包）」。
- 保存配置后，在目标语言文章中执行翻译。
- 检查标题、正文、SEO、FAQ 和资源文字，确认实际保存结果。
代码要求开关开启且 AI 地址、密钥、模型齐全，文章翻译才走 AI。开关开着但参数不齐，不能据此认定已经调用 AI。
AI 已被选中而调用失败时，默认直接报错，不自动切到翻译厂家；项目有开发扩展回退入口，但不是普通后台自动兜底选项。批量翻译也使用文章翻译模式，不过翻译字段由任务勾选项决定。
设置字段自动翻译
多语言输入框通常在第一种语言处显示「自动翻译」。填写源文字后触发自动填充，检查其他语言结果，再保存整个设置。
这个按钮不负责创建文章译文，也不受文章 AI 翻译开关控制。网站名称、SEO 多语言文案和文章正文属于不同对象，不能互相代替。
翻译后的检查
译文应保持链接、价格、单位、占位符和功能名称正确。代码有 HTML 占位保护和分段处理，但这不能保证所有模型输出都正确；尤其下载地址、提取码、商品规格、交付文字需要逐项检查。
完成配置并检查结果
先准备所选 AI 或普通翻译服务的凭据，再决定是否启用文章整包 AI 翻译。用一篇短文章检查标题、正文及支持的附加字段。普通翻译和整包 AI 翻译应分别检查，不能因为其中一种配置完成就认为另一种已经可用。
四、常见问题
常见问法与直接答案
AI 翻译失败会自动换百度吗？
默认不会。文章整包翻译选用 AI 后，当前默认配置不在失败时自动退回普通翻译厂家。先看错误并核对通道、模型及凭据，处理后再执行；不要把源文仍在误认为已完成翻译。
更多使用问题
AI 翻译失败后会自动切换普通翻译吗？
不能作此预期。先检查当前使用的通道、模型与返回错误，再处理或重试对应任务。