> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tooken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 6.5 错误码与限流说明

## **6.5 错误码与限流说明**

### **HTTP 状态码**

| **状态码** | **含义** | **处理建议**               |
| ------- | ------ | ---------------------- |
| 200     | 成功     | —                      |
| 400     | 请求参数错误 | 检查请求体格式                |
| 401     | 认证失败   | 检查 API Key 是否正确        |
| 402     | 余额不足   | 充值 Credits 或配置 x402 钱包 |
| 403     | 无权限    | 检查 Key 的模型访问权限         |
| 429     | 超出限流   | 降低请求频率，或联系商务升级限额       |
| 500     | 服务内部错误 | 重试，或联系技术支持             |
| 502     | 上游服务错误 | 平台正在自动切换节点，稍后重试        |
| 503     | 服务不可用  | 流量高峰，系统正在扩容，稍后重试       |

### **限流规则**

| **账户类型** | **请求/分钟** | **Token/分钟** | **并发请求** |
| -------- | --------- | ------------ | -------- |
| 免费       | 10        | 40,000       | 2        |
| 入门版      | 60        | 200,000      | 5        |
| 专业版      | 300       | 1,000,000    | 20       |
| 企业版      | 2,000     | 10,000,000   | 100      |
| 旗舰版      | 自定义       | 自定义          | 自定义      |

### **推荐重试策略**

```
import time
import random

def call_with_retry(client, max_retries=3, **kwargs):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(**kwargs)
        except Exception as e:
            if "429" in str(e):
                # 指数退避 + 随机抖动
                wait_time = (2 ** attempt) + random.uniform(0, 1)
                print(f"限流，{wait_time:.1f}秒后重试...")
                time.sleep(wait_time)
            elif "502" in str(e) or "503" in str(e):
                # 上游故障，快速重试
                time.sleep(1)
            else:
                raise e
    raise Exception("超过最大重试次数")
```

***

## **附录**

### **常见问题**

**Q：Auto 路由会不会不稳定，每次用不同模型导致结果不一致？**

A：Auto 路由会根据任务类型选择同一档次的模型，对于需要严格一致性的场景，建议指定具体模型。

**Q：链上支付是否需要 KYC？**

A：使用加密钱包登录和链上支付无需 KYC。仅企业采购需要提供营业执照用于开票。

**Q：Agent 钱包的私钥如何安全存储？**

A：推荐使用 AWS KMS / HashiCorp Vault 等密钥管理服务存储，避免明文写入代码或配置文件。

**Q：x402 支付协议支持哪些区块链？**

A：当前支持 Ethereum、Base、Solana。计划中：Arbitrum、Polygon、BNB Chain。

**Q：如果平台故障，我的资产安全吗？**

A：链上支付的资产由智能合约托管，平台无法单方面挪用。Credits 余额对应的稳定币由多签钱包管理，定期审计。

***

### **更新日志**

| **版本** | **日期**      | **主要更新**                         |
| ------ | ----------- | -------------------------------- |
| v1.0.0 | 2026-04     | 平台上线，多模型聚合 + Auto 路由 + 链上支付      |
| v1.1.0 | 2026 Q3（计划） | x402 实时结算上线                      |
| v2.0.0 | 2027（计划）    | Agent 钱包 + ERC-8183 合约层 + A2A 协议 |