1. 注册开发者账号并获取API密钥

- 访问[有道智云平台](https://ai.youdao.com/)注册账号。
- 进入「控制台」→「应用管理」创建应用,获取 应用ID(APP Key) 和 密钥(APP Secret)。
2. 查阅API文档

- 官方文档地址:[有道翻译API文档](https://ai.youdao.com/DOCSIRMA/html/翻译API/文本翻译服务/文本翻译服务-API文档.html)
- 重点关注:
- 接口地址:`https://openapi.youdao.com/api`
- 支持的参数(如 `q`、`from`、`to`、`appKey`、`salt`、`sign` 等)。
3. 生成签名(Sign)

签名是加密字符串,用于验证请求合法性。计算公式:
`sign = md5(appKey + q + salt + appSecret)`
- `q`: 待翻译文本(多个文本用 `\n` 分隔,实现批量)。
- `salt`: 随机字符串。
- `appKey/appSecret`: 你的密钥。
4. 发送HTTP请求

请求示例(Python)

```python
import hashlib
import uuid
import requests
def translate_batch(texts, from_lang="auto", to_lang="en"):
url = "https://openapi.youdao.com/api"
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
q = "\n".join(texts) # 批量文本用\n连接
salt = str(uuid.uuid1())
sign_str = app_key + q + salt + app_secret
sign = hashlib.md5(sign_str.encode()).hexdigest()
params = {
"q": q,
"from": from_lang,
"to": to_lang,
"appKey": app_key,
"salt": salt,
"sign": sign,
}
response = requests.get(url, params=params)
return response.json()
# 示例:批量翻译两句话
texts = ["你好", "世界"]
result = translate_batch(texts)
print(result)
```
返回结果

返回为JSON格式,包含翻译结果(`translation`)和每个句子的详细数据。
5. 注意事项

批量限制:单次请求最多翻译5000字符,文本过多需分批次。
频率限制:免费版有QPS(每秒请求数)限制,付费可提升。
语言支持:支持中英日韩等常见语言,详见文档。
错误码:如 `401`(密钥无效)、`413`(文本过长)等,需处理异常。
6. 高级功能(付费)

领域翻译:如医疗、金融等专业术语。
术语库:自定义翻译词汇。
遇到问题时,建议先检查签名生成和参数格式是否正确,或联系有道智云技术支持。