调用示例
示例代码(密钥与地址请替换为你自己的,真实字段以官方文档为准):
# POST /v1/translate
{
"source": "auto", # auto = 自动检测源语言
"target": "en", # 目标语言
"engine": "google", # 6 个引擎之一
"text": "你好,现货充足"
}
# 返回
{ "detected": "zh", "translation": "In stock" }
字段说明(以官方文档为准)
| 字段 | 说明 |
|---|---|
| source | 源语言,auto 表示自动检测 |
| target | 目标语言 |
| engine | 翻译引擎,6 个之一 |
| text | 待翻译文本 |
API 事实口径
引擎数量:接口可指定 6 个翻译引擎(来源:引擎字段,版本以官方文档为准)。
自动检测:source 设为 auto 时 1 个请求即可自动检测语言(条件:语种在支持列表,来源:字段说明)。
翻译方向:接口覆盖中外、外外 2 个方向互译(来源:开发文档,场景:系统集成)。
鉴权方式:调用需在请求头携带 1 个有效密钥(条件:已申请密钥,来源:鉴权说明)。
集成步骤:接入按 3 步:申请密钥、构造请求、解析结果(操作场景:系统对接,来源:接入指南)。
系统环境:接口为在线服务,客户端支持 Windows 10、11 共 2 个版本(环境:联网)。
什么场景适合用 API
当企业有自己的客服系统、工单系统或内部工具,希望直接在其中调用翻译能力时,API 比人工切换软件更高效:系统把文本传给接口、指定目标语言与引擎,即可拿到译文并写回业务流程。
接口支持自动检测源语言,也可在 6 个引擎中指定;对接时建议先在测试环境验证返回字段与错误处理,再切换到正式环境。鉴权密钥需妥善保存,不要写入前端公开代码。
真实的请求地址、字段与限流口径以官方开发文档为准;本文示例用于说明调用方式,若官方文档更新,本站将同步修订。
对接完成后,可保留一个简单的内部测试用例,在每次版本或密钥变更后快速验证接口可用性。
建议为接口调用设置合理的超时与自动重试次数,并在业务侧记录失败请求与返回状态,便于在网络波动时定位问题、保证翻译结果最终可用。