LuckyAPI 令牌分组配置指南
LuckyAPI 提供灵活的令牌分组功能,可以根据不同场景自动选择最优的 API 路由策略,提升调用成功率和性价比。
前提条件
- 已注册 LuckyAPI 账户并充值
- 已创建 API Key
配置步骤
1. 打开 LuckyAPI 控制台
访问 LuckyAPI 官网,登录后点击顶部导航栏的 "控制台"。
2. 编辑令牌配置
- 在左侧菜单找到 "令牌管理"
- 在令牌列表中,找到需要配置的 Key
- 点击该 Key 对应的 "编辑" 按钮
3. 配置令牌分组
在 "令牌分组" 下拉菜单中选择:
- ❌ 不推荐:
default(默认分组) - ✅ 推荐:
auto(自动路由)
为什么推荐 auto?
auto 分组不是单纯选最便宜的,而是追求 高质低价。
4. 启用跨分组重试
在同一编辑页面,勾选 "跨分组重试" 选项。
跨分组重试的作用
当当前分组的模型不可用时,自动尝试其他分组,提高成功率。不会重复计费,只有成功的请求才会计费。
5. 保存配置
点击 "提交" 保存配置,立即生效。
网络配置建议
⚠️ 重要提示:国内直连,无需代理
在 Claude Code、Cursor、Continue 等工具中配置 LuckyAPI 时:
- ✅ 推荐:直接使用 LuckyAPI 的 API 地址,无需配置代理
- ❌ 不推荐:使用代理(可能导致连接失败)
为什么不推荐使用代理?
- LuckyAPI 已针对国内网络优化,直连速度更快
- 使用代理反而可能因为代理服务器不稳定导致请求失败
- 特别是在 Claude Code、Cursor 等工具中,加代理可能导致 SSL 握手失败
常见问题(FAQ)
Q1: 为什么不推荐使用 default 分组?
A: default 分组中 没有任何模型,无法正常使用。
如果不使用 auto 分组,请按以下步骤操作:
- 访问 模型广场 查看所有可用模型
- 找到您需要调用的模型所在的分组
- 在令牌编辑页面,将分组切换到对应的分组
推荐使用 auto 分组,可以自动根据实时情况选择最优路径,无需手动切换。
Q2: 跨分组重试会增加费用吗?
A: 不会。跨分组重试只是在当前请求失败时尝试其他分组,不会重复计费。只有成功的请求才会计费。
Q3: 配置后多久生效?
A: 立即生效。保存配置后,下一次 API 请求就会使用新的分组设置。
Q4: 我在 Claude Code 中配置了代理,但连接失败怎么办?
A:
- 移除代理配置(取消
HTTP_PROXY和HTTPS_PROXY环境变量) - 直接使用 LuckyAPI 的 API 地址
- 确保网络畅通(可以 ping 一下
cn.luckyapi.chat)
bash
# 临时取消代理
unset HTTP_PROXY
unset HTTPS_PROXY
unset http_proxy
unset https_proxypowershell
# 临时取消代理
$env:HTTP_PROXY = ""
$env:HTTPS_PROXY = ""Q5: 如何查看当前使用的是哪个分组?
A:
- 在 LuckyAPI 控制台的 "使用记录" 中可以看到每次请求使用的分组
- 如果启用了跨分组重试,记录中会显示重试的分组信息
Q6: auto 分组会自动切换到最便宜的模型吗?
A: 不会。auto 的策略是 高质低价,优先保证质量,而不是单纯追求最低价格。
Q7: 如何查看模型的实时可用性?
A: 为提升透明度与使用体验,平台已提供 模型可用性实时监控页面。
您可以查看当前各模型的可用状态、响应情况及运行稳定性信息。
访问方式:
- 直接访问:模型可用性监控页面
- 或通过 LuckyAPI 导航栏 "关于" 页面查看
Q8: 我的代理很稳定,为什么还是建议不用代理?
A: 即使代理稳定,也可能遇到以下问题:
- 代理服务器的 SSL 证书与 LuckyAPI 不匹配
- 代理增加了额外的网络延迟
- 某些工具(如 Claude Code)对代理支持不完善
LuckyAPI 本身已经针对国内网络优化,直连是最稳定的方案。
推荐配置总结
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 令牌分组 | auto | 自动选择最优路径 |
| 跨分组重试 | ✅ 启用 | 提高成功率 |
| 代理配置 | ❌ 不使用 | 国内直连更稳定 |
技术支持
如有问题,请访问 LuckyAPI 官网 获取支持,或查看 Claude Code 中文站 其他教程。
最后更新:2026-03-10