故障排除

使用 MyTokenGate 时的常见问题及解决方案。

认证错误

API 密钥无效

错误：401 Unauthorized - Invalid API key

解决方案：

1. 在控制台验证您的 API 密钥
2. 确保没有多余空格或换行符
3. 检查密钥是否已被撤销
4. 如需要，生成新密钥

Token 过期

错误：401 Unauthorized - Token expired

解决方案：

• 刷新您的认证 token
• 在应用中实现 token 刷新逻辑

限流问题

超过限流

错误：429 Too Many Requests

解决方案：

1. 实现指数退避：

import time
import random
 
def retry_with_backoff(func, max_retries=5):
    for i in range(max_retries):
        try:
            return func()
        except RateLimitError:
            wait = (2 ** i) + random.random()
            time.sleep(wait)

2. 检查限流响应头：

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1682524800

模型错误

模型未找到

错误：404 Not Found - Model not available

解决方案：

1. 检查可用模型：GET /v1/models
2. 验证模型名称拼写
3. 某些模型需要特殊权限

上下文长度超限

错误：400 Bad Request - Context length exceeded

解决方案：

1. 减少输入 token 数量
2. 使用更大上下文窗口的模型
3. 实现文本分块

连接问题

超时错误

错误：504 Gateway Timeout

解决方案：

1. 增加客户端超时设置
2. 对长响应使用流式传输
3. 检查网络连接

连接被拒绝

错误：ECONNREFUSED

解决方案：

1. 验证 API 端点 URL
2. 检查防火墙设置
3. 确保 SSL/TLS 配置正确

计费问题

余额不足

错误：402 Payment Required - Insufficient balance

解决方案：

1. 检查账户余额
2. 充值
3. 设置自动充值

需要更多帮助？

• 查看 常见问题 获取常见问题解答
• 联系支持：support@mytokengate.com
• 加入我们的 社区 获取同伴支持