Skip to content

RATE_LIMIT_SOLUTIONS.md

Latest commit

 

History

History
214 lines (150 loc) · 4.07 KB

RATE_LIMIT_SOLUTIONS.md

File metadata and controls

214 lines (150 loc) · 4.07 KB
Raw

OpenRouter 速率限制解决方案

问题描述

遇到 OpenRouter API 的速率限制错误：

Rate limit exceeded: free-models-per-day. Add 10 credits to unlock 1000 free model requests per day

错误详情：

  • 错误代码：429
  • 限制类型：免费模型每日请求限制
  • 当前限制：50 次/天
  • 剩余请求：0 次

解决方案

方案 1: 等待重置（推荐）

  • 时间：等待到明天（UTC 时间）
  • 成本：免费
  • 优点：无需额外费用
  • 缺点：需要等待

方案 2: 添加积分解锁

  • 费用：10 积分（约$0.10）
  • 解锁：1000 次免费模型请求/天
  • 步骤：
    1. 访问 OpenRouter 控制台
    2. 添加 10 积分
    3. 立即解锁 1000 次请求

方案 3: 切换到其他 API 提供商

3.1 DeepSeek API

# 在设置中切换到DeepSeek
API类型: DeepSeek
模型: deepseek-chat
API密钥: 你的DeepSeek API密钥

3.2 豆包 API

# 在设置中切换到豆包
API类型: Doubao
模型: doubao-lite-4k
API密钥: 你的豆包API密钥

3.3 KIMI API

# 在设置中切换到KIMI
API类型: KIMI
模型: moonshot-v1-8k
API密钥: 你的KIMI API密钥

方案 4: 使用本地 Ollama（推荐）

4.1 安装 Ollama

  1. 访问 Ollama 官网
  2. 下载并安装 Ollama
  3. 启动 Ollama 服务

4.2 下载模型

# 下载推荐的对话模型
ollama pull llama3.2:3b
ollama pull qwen2.5:3b
ollama pull gemma2:2b

4.3 配置游戏

# 在设置中切换到Ollama
API类型: Ollama
模型: llama3.2:3b
API密钥: 留空（本地不需要）

自动备用 API 系统

游戏现在支持自动 API 切换：

功能特点

  • 自动检测：检测 API 错误和速率限制
  • 智能切换：自动切换到可用的 API
  • 错误恢复：定期重置错误计数
  • 状态监控：实时监控 API 状态

API 优先级

  1. OpenRouter（免费模型）
  2. DeepSeek
  3. 豆包
  4. KIMI
  5. OpenAI
  6. Gemini
  7. Claude
  8. Ollama（本地）

使用方法

系统会自动处理 API 切换，无需手动干预。当检测到速率限制时：

  1. 自动标记当前 API 为不可用
  2. 切换到下一个可用的 API
  3. 显示友好的错误提示
  4. 定期重置错误状态

推荐配置

开发环境

主API: Ollama (本地)
备用API: DeepSeek
模型: llama3.2:3b

生产环境

主API: OpenRouter
备用API: DeepSeek
模型: qwen/qwen3-235b-a22b:free

高使用量环境

主API: DeepSeek
备用API: 豆包
模型: deepseek-chat

监控和调试

查看 API 状态

游戏会在控制台输出 API 状态信息：

[APIFallbackManager] 使用API: DeepSeek
[APIFallbackManager] API OpenRouter 报告错误: Rate limit exceeded
[APIFallbackManager] 切换到API: DeepSeek

错误处理

  • 自动显示用户友好的错误提示
  • 提供解决方案建议
  • 记录详细的错误日志

成本对比

API 提供商 免费额度 付费价格 推荐场景
OpenRouter 50 次/天 $0.10/1000 次 轻度使用
DeepSeek 有限 $0.14/1M tokens 中等使用
豆包 有限 按量计费 中文优化
KIMI 有限 按量计费 长文本
Ollama 无限制 免费 本地部署

故障排除

问题 1: 所有 API 都不可用

解决方案：

  1. 检查网络连接
  2. 验证 API 密钥
  3. 重启游戏
  4. 使用本地 Ollama

问题 2: 自动切换不工作

解决方案：

  1. 检查 APIFallbackManager 是否启动
  2. 查看控制台错误信息
  3. 手动切换 API

问题 3: 本地 Ollama 连接失败

解决方案：

  1. 确认 Ollama 服务运行
  2. 检查端口设置（默认 11434）
  3. 验证模型已下载
  4. 重启 Ollama 服务

更新日志

v1.0 - 速率限制处理

  • 添加友好的错误提示
  • 实现自动 API 切换
  • 支持多种备用 API
  • 优化错误处理机制