调用有道智云翻译 / 词典 / OCR / TTS 接口返回了 errorCode?先想清三件事——是客户端可自查的参数 / 签名问题,还是服务端 / 计费问题、签名串顺序与编码对不对、QPS 有没有超。输入或点选你拿到的错误码或关键词(如 202、411、108、签名、限流、时间戳),先看 L1 官方含义,再看 L2 深度真因与排查,最后对照竞品与真实场景。需要官方接入文档可到 有道智云 API 错误码 / 接入指南 。
第一步:按错误码区间分流(L1·先分清谁的锅)
有道智云的 errorCode 大致分四段,先按段定位、别瞎试:① 1xx 参数类(101 缺参 / 102 语种 / 103 过长 / 113 q 空 / 116 strict)——客户端自查必填与取值;② 2xx 鉴权与签名类(108 应用ID / 202 签名 / 203 IP / 205 平台 / 206 时间戳 / 207 重放)——查签名串与凭证;③ 3xx/5xx 服务端类(303 / 500 / 902000)——带 request_id 重试或提工单;④ 4xx 账号/计费/限流类(401 欠费 / 411 / 412 限流)——查余额与 QPS。更完整的接入对照见 有道 API 签名(v3)生成与 202 排查 。
参数类 (
101 · 102 · 103 · 113 · 116): 客户端自查:必填字段齐全(q/from/to/appKey/sign/signType/curtime/salt),语种代码用 zh-CHS / en / auto,q 非空且不超长,strict 取 true/false。鉴权 / 签名类 (
108 · 111 · 202 · 203 · 205 · 206 · 207): 签名串 appKey+input+salt+curtime+appSecret 做 SHA256;curtime 秒级 UTC、salt 用 UUID 防重放;IP 白名单与应用平台类型对齐。服务 / 实例类 (
110 · 310): 一个应用要按服务逐个绑定实例(翻译 / 语音合成 TTS / OCR 各自独立);领域化翻译需先在控制台开通。账号 / 计费 / 限流类 (
401 · 411 · 412): 余额 / 字符资源包别用尽(401 欠费停服);QPS(基础约 100)超限会 411,客户端做令牌桶限速 + 指数退避。
-
结果 / 解密 / 其它类 (
201 · 303 · 500 · 902000): 服务端类异常带 request_id 重试或提工单;加密接口核对 DES / BASE64 / URLDecode 顺序。
第二步:最高频两个坑 → 深度真因(L2·签名 202 与限流 411)
关键认知:90% 的有道 API 报错卡在「签名 202」和「限流 411」上。202 不是密钥错,多半是 v3 签名串没拼对——sign = sha256(应用ID + input + salt + curtime + 应用密钥),其中 input 在 q 长度>20 时取「前 10 字符 + q 长度 + 后 10 字符」(按 Unicode 字符、非字节),≤20 取 q 本身;再叠加 UTF-8 编码、顺序、首尾空格几个坑。411 则是 QPS 超了套餐上限,要客户端限速 + 退避。下图是调用前自检面板示意;再往下是竞品横向对照与 2026 估算。
竞品翻译 API 横向对照(签名 / 错误码 / 免费额度 · 公开口径)
| 服务 | 签名 / 鉴权 | 错误码风格 | 免费额度(估算) | QPS / 频率(估算) |
|---|---|---|---|---|
| 有道智云 | SHA256 · v3(appKey+input+salt+curtime+secret) | 3 位数字(101 / 202 / 411) | 各服务有体验额度 | 基础约 100 QPS(可叠加) |
| 百度翻译开放平台 | MD5 32 位小写(appid+q+salt+密钥) | 5 万段(52001 / 54001 / 54003 / 58001) | 标准版免费 | 标准 1 / 高级 10 / 尊享 100 |
| 腾讯云 TMT | TC3-HMAC-SHA256 | 字符串(RequestLimitExceeded / NoFreeAmount) | 每月 500 万字符 | 默认 5 次 / 秒 |
| 阿里云机器翻译 | HMAC(RPC / ROA 通用签名) | 字符串(如 InvalidApiKey) | 每月免费额度(按版本) | 按 QPS 配额 |
| Google Cloud Translation | API Key / OAuth2 | HTTP 状态 + reason(403 / 429) | 每月前 50 万字符(v2) | 按项目配额 |
| DeepL API | DeepL-Auth-Key 请求头 | HTTP(403 / 456 / 429) | Free 50 万字符 / 月 | 按计划配额 |
翻译 API 错误处理与额度对照(2026 估算)
以下为综合各家官方开放平台文档(有道智云、百度翻译、腾讯云、阿里云、Google、DeepL)的 2026 估算(非各厂商承诺值、非一手实测,仅供参考;额度与 QPS 随官方政策调整):
| 维度 | 估算 / 对照 |
|---|---|
| 签名算法(鉴权方式) | 有道 SHA256(v3) · 百度 MD5 · 腾讯 TC3-HMAC-SHA256 · 阿里 HMAC · Google API Key · DeepL Auth-Key 头 |
| 免费额度(每月 · 估算) | 腾讯 500 万字符 > Google / DeepL 各 50 万字符 > 百度标准版免费(QPS=1);有道各服务有体验额度,以控制台为准 |
| QPS / 频率上限(估算) | 有道基础约 100(可叠加)· 百度 标准 1 / 高级 10 / 尊享 100 · 腾讯默认 5 次/秒 |
| 单次文本长度上限(估算) | 有道大模型 / 文档接口 i ≤ 5000 字符 · 腾讯单次 < 6000 字符(超长走文档 / 批量接口) |
| 最高频错误码(社区经验 · 估算) | 202 签名 > 411 限流 > 108 / 110 绑定 > 206 时间戳 占报错大头 |
估算口径:信源基线 + 时间外推(综合有道智云 / 百度 / 腾讯云 / 阿里云 / Google / DeepL 官方开放平台文档 2026 抓取),随各家政策与版本会变;请以各家最新官方控制台为准。
真实场景速判
本地能调、上云 / 容器后大面积 206:容器时钟漂移导致 curtime 失效(签名约 120s 有效)→ 开 NTP 校时、容器同步宿主时钟,别缓存旧 curtime。
翻译英文正常、翻译长中文偶发 202:truncate 把多字节中文按「字节」切了 → input 必须按 Unicode 字符数(q>20 取前 10 字符 + q 长度 + 后 10 字符)。
salt 写死或自增、第二次调用就 207:salt 必须每次随机(UUID)并刷新 curtime,失败重试要重新签名、不能原样重发。
压测瞬时并发大面积 411:基础 QPS 约 100,超了被限流 → 客户端令牌桶限速 + 指数退避,或控制台叠加购买 QPS。
新建应用直接取翻译发音报 110:翻译实例绑了、语音合成(TTS)实例没绑 → 控制台为应用按服务逐个绑定实例。
调用突然全部 401:字符资源包 / 余额用尽欠费停服 → 充值或购买资源包并设余额告警,关键链路备兜底渠道。
从百度迁来的同坑:签名拼接前就对 q 做了 URL encode → 有道 v3 用 input(截断规则)参与签名、不是先对 q 编码;应先签名、发请求时再对 q 做 URL encode。
相关
有道 API 开发者工具(姊妹站)
More: Youdao










