常见问题

API Key 相关

如何获取 API Key？

1. 注册 并 登录 TopRouter 账号
2. 在控制台中创建新的 API Key
3. 复制并妥善保管您的 API Key

⚠️ 安全提示

API Key 只会在创建时完整显示一次，请务必立即保存。如果丢失，需要创建新的 Key。

API Key 可以创建多个吗？

可以。您可以根据不同的用途创建多个 API Key，方便管理和追踪用量。

API Key 被泄露了怎么办？

请立即登录控制台删除被泄露的 Key，并创建新的 Key。同时检查账户余额是否有异常消费。

计费相关

如何充值？

通过 AI额度兑换码 购买兑换码，然后在 兑换页面 输入兑换码即可充值。详细步骤请参考 充值与兑换。

不同模型的费率一样吗？

不同模型的费率不同。一般来说，能力更强的模型（如 Claude 4.8 Opus、GPT-5.5）费率高于轻量模型（如 Claude Haiku、GPT-5.5-mini）。具体费率请参考 模型列表。

余额会过期吗？

目前充值余额不会过期，您可以放心使用。

如何查看使用记录？

登录 TopRouter 控制台，可以查看 API 调用记录和余额变动详情。

模型相关

支持哪些模型？

TopRouter 支持 200+ AI 模型，包括：

• 聊天补全：Claude 4.8 Opus、Claude 4.6 Sonnet、GPT-5.5、GPT-5.5 Thinking、Gemini 3.1 Pro 等
• 图像生成：DALL-E 3、GPT Image、Flux 等
• 视频生成：Seedance 等

完整列表请查看 模型列表。

如何获取可用模型列表？

通过 API 查询：

curl https://toprouter.cc/models \
  -H "Authorization: Bearer your-api-key"

模型名称怎么填？

使用与 OpenAI 兼容的模型标识符，例如：

• anthropic/claude-4.6-sonnet
• gpt-5.5
• google/gemini-3.1-pro

具体名称请参考 模型列表。

速率限制

有速率限制吗？

有。TopRouter 会根据您的账户等级和模型类型设置不同的速率限制。详情请参考 速率限制。

遇到 429 错误怎么办？

429 Too Many Requests 表示请求频率超过限制。建议：

1. 降低请求频率
2. 实现指数退避重试机制
3. 如需更高限额，请联系客服

错误处理

常见错误码

错误码	含义	解决方案
400	请求参数错误	检查请求体格式和参数
401	认证失败	检查 API Key 是否正确
403	权限不足	确认账户状态和余额
404	资源不存在	检查模型名称和端点路径
429	请求过于频繁	降低请求频率，实施重试策略
500	服务器内部错误	稍后重试，如持续出现请联系客服
503	服务暂时不可用	上游模型暂时不可用，稍后重试

更多详情请参考 错误处理。

API 请求超时？

• 默认超时时间较长，足以覆盖大部分请求
• 如果使用复杂模型或长输出，请适当增加客户端超时设置
• 流式请求 (stream: true) 可以更快获得首字响应

兼容性

可以用 OpenAI SDK 吗？

可以。TopRouter 完全兼容 OpenAI API 格式，您只需将 base_url 改为 https://toprouter.cc 即可。

支持哪些客户端工具？

TopRouter 支持多种客户端工具：

• Claude Code
• Claude Desktop
• Cursor / Windsurf
• Cherry Studio
• OpenAI Codex
• 以及其他支持 OpenAI 兼容 API 的工具

联系支持

如果您的问题未在上述内容中找到答案，请通过以下渠道联系我们：

• Telegram：t.me/+usySmwAIO-I3YjBl
• Discord：discord.gg/URHXXkVJ6y
• Whop 群聊：加入群聊