有道翻译 API 开发者接入教程

有道翻译 API（有道智云翻译服务）面向开发者提供机器翻译相关接口，常见用途包括文本翻译、图片识别翻译、语音或文档处理等。具体能力、开通条件和计费方式会随控制台调整，接入前应先查看有道智云当前文档。

API 接入时重点核对三件事：当前支持的语言方向、接口调用方式、以及控制台显示的免费额度和超额计费。不要按旧文章里的语种数、免费字符数或单价做预算，开发前先用测试应用跑一小批真实文本。

🔑 注册与获取 API 密钥

使用有道翻译 API 前，需要先在有道智云平台注册并创建应用以获取 API 密钥：

💻 API 调用方法

请求参数说明

有道翻译 API 的核心接口为文本翻译接口，请求地址为 https://openapi.youdao.com/api。主要请求参数包括：

• q — 待翻译的文本内容（UTF-8 编码）
• from — 源语言代码（如 zh-CHS 代表简体中文，en 代表英文，auto 代表自动检测）
• to — 目标语言代码
• appKey — 应用 ID
• salt — 随机数（UUID 即可）
• sign — 签名（使用 SHA-256 算法对 appKey+input+salt+curtime+密钥 进行哈希）
• signType — 签名类型，固定为 v3
• curtime — 当前 UTC 时间戳（秒级）

Python 调用示例

以下是使用 Python 调用有道翻译 API 的完整代码示例：

import hashlib
import uuid
import time
import requests

YOUDAO_URL = 'https://openapi.youdao.com/api'
APP_KEY = '你的AppKey'
APP_SECRET = '你的AppSecret'

def translate(text, from_lang='auto', to_lang='zh-tw'):
    salt = str(uuid.uuid4())
    curtime = str(int(time.time()))
    sign_str = APP_KEY + truncate(text) + salt + curtime + APP_SECRET
    sign = hashlib.sha256(sign_str.encode('utf-8')).hexdigest()

    params = {
        'q': text,
        'from': from_lang,
        'to': to_lang,
        'appKey': APP_KEY,
        'salt': salt,
        'sign': sign,
        'signType': 'v3',
        'curtime': curtime,
    }
    response = requests.post(YOUDAO_URL, data=params)
    return response.json()

def truncate(text):
    if len(text) <= 20:
        return text
    return text[:10] + str(len(text)) + text[-10:]

result = translate('有道翻译是一款很好用的翻译软件')
print(result['translation'])

Node.js 调用示例

const crypto = require('crypto');
const axios = require('axios');
const { v4: uuidv4 } = require('uuid');

const APP_KEY = '你的AppKey';
const APP_SECRET = '你的AppSecret';
const API_URL = 'https://openapi.youdao.com/api';

function truncate(q) {
  if (q.length <= 20) return q;
  return q.substring(0, 10) + q.length + q.substring(q.length - 10);
}

async function translate(text, from = 'auto', to = 'en') {
  const salt = uuidv4();
  const curtime = Math.round(Date.now() / 1000).toString();
  const signStr = APP_KEY + truncate(text) + salt + curtime + APP_SECRET;
  const sign = crypto.createHash('sha256').update(signStr).digest('hex');

  const { data } = await axios.post(API_URL, null, {
    params: { q: text, from, to, appKey: APP_KEY, salt, sign, signType: 'v3', curtime }
  });
  return data;
}

translate('有道翻译API测试').then(res => console.log(res.translation));

💰 计费与套餐

有道翻译 API 的计费方式、免费额度和套餐价格会随产品策略调整。下面只保留开发者做预算时应该核对的项目，具体数字以有道智云当前文档和控制台显示为准：

• 免费额度：是否仍提供试用额度，以及额度适用于哪些接口
• 按量计费：文本、图片、语音和文档接口是否分开计费
• 预购套餐：套餐是否有有效期、调用范围和超额计费规则
• 企业定制：大批量调用时是否需要单独申请商务报价或 SLA

语音翻译、图片翻译和文档翻译的计费方式有所不同，具体可参考有道智云官方文档。API 控制台提供了详细的用量统计和费用明细，方便开发者监控和管理用量。

❓ 常见问题