调用有道智云翻译 / 词典 / 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
