# 错误码字典

`errorId` 永远是 `0` 或 `1`。`errorCode` 字符串是契约，**不翻译**。

| errorCode | When | Description | Client action |
|---|---|---|---|
| `ERROR_KEY_DOES_NOT_EXIST` | — | clientKey 无效或不存在 | 到门户核对密钥；不要用同一值重试。 |
| `ERROR_ZERO_BALANCE` | — | 可用余额不足 | 停止下单并充值。可用余额 = balance − frozenAmount。 |
| `ERROR_TASK_NOT_SUPPORTED` | — | 不支持该任务类型 | 检查类型字符串以及后台是否启用。停用类型当前也返回此码。 |
| `ERROR_TASK_NOT_ACTIVE` | — | 该任务类型已停用（当前实现不会返回，停用表现为 NOT_SUPPORTED） | 仅为兼容列出。今日二进制不会返回：停用类型从注册表消失。 |
| `ERROR_TASK_DENIED` | — | 任务创建被拒绝 | 账户被拒绝。联系支持。 |
| `ERROR_RATE_LIMIT` | — | 请求过于频繁 | 退避重试；窗口按 API 密钥计。 |
| `ERROR_NO_SLOT_AVAILABLE` | — | 暂无可用处理槽 | 稍后重试。Akamai 会话繁忙时也会返回。 |
| `CAPTCHA_NOT_READY` | — | 任务结果尚未就绪 | 继续每 1–2 秒轮询 getTaskResult。 |
| `ERROR_CAPTCHA_UNSOLVABLE` | — | 未能识别该验证码 | 不要盲目重试计费；检查站点和参数。 |
| `ERROR_BAD_REQUEST` | — | 请求参数不合法 | 修正缺参、类型、URL/base64 或超时。 |
| `ERROR_INTERNAL` | — | 服务器内部错误 | 退避重试；持续出现则联系支持。 |
| `ERROR_TASK_NOT_FOUND` | — | 任务不存在 | taskId 错误或不属于当前密钥。 |
| `ERROR_TASK_EXPIRED` | — | 任务已过期 | 重新创建任务。Akamai 浏览器会话过期时也会返回。 |
| `ERROR_TOO_MANY_REQUESTS` | — | 查询次数超限 | 停止查询该 taskId（上限 120 次）。 |

Source: https://kaptra.ai/zh/docs/error-codes/error-dictionary