Skip to content

LuckyAPI 令牌分组配置指南

LuckyAPI 提供灵活的令牌分组功能,可以根据不同场景自动选择最优的 API 路由策略,提升调用成功率和性价比。

前提条件

  • 已注册 LuckyAPI 账户并充值
  • 已创建 API Key

配置步骤

1. 打开 LuckyAPI 控制台

访问 LuckyAPI 官网,登录后点击顶部导航栏的 "控制台"

2. 编辑令牌配置

  1. 在左侧菜单找到 "令牌管理"
  2. 在令牌列表中,找到需要配置的 Key
  3. 点击该 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 分组,请按以下步骤操作:

  1. 访问 模型广场 查看所有可用模型
  2. 找到您需要调用的模型所在的分组
  3. 在令牌编辑页面,将分组切换到对应的分组

推荐使用 auto 分组,可以自动根据实时情况选择最优路径,无需手动切换。


Q2: 跨分组重试会增加费用吗?

A: 不会。跨分组重试只是在当前请求失败时尝试其他分组,不会重复计费。只有成功的请求才会计费。


Q3: 配置后多久生效?

A: 立即生效。保存配置后,下一次 API 请求就会使用新的分组设置。


Q4: 我在 Claude Code 中配置了代理,但连接失败怎么办?

A:

  1. 移除代理配置(取消 HTTP_PROXYHTTPS_PROXY 环境变量)
  2. 直接使用 LuckyAPI 的 API 地址
  3. 确保网络畅通(可以 ping 一下 cn.luckyapi.chat
bash
# 临时取消代理
unset HTTP_PROXY
unset HTTPS_PROXY
unset http_proxy
unset https_proxy
powershell
# 临时取消代理
$env:HTTP_PROXY = ""
$env:HTTPS_PROXY = ""

Q5: 如何查看当前使用的是哪个分组?

A:

  1. 在 LuckyAPI 控制台的 "使用记录" 中可以看到每次请求使用的分组
  2. 如果启用了跨分组重试,记录中会显示重试的分组信息

Q6: auto 分组会自动切换到最便宜的模型吗?

A: 不会。auto 的策略是 高质低价,优先保证质量,而不是单纯追求最低价格。


Q7: 如何查看模型的实时可用性?

A: 为提升透明度与使用体验,平台已提供 模型可用性实时监控页面

您可以查看当前各模型的可用状态、响应情况及运行稳定性信息。

访问方式:


Q8: 我的代理很稳定,为什么还是建议不用代理?

A: 即使代理稳定,也可能遇到以下问题:

  • 代理服务器的 SSL 证书与 LuckyAPI 不匹配
  • 代理增加了额外的网络延迟
  • 某些工具(如 Claude Code)对代理支持不完善

LuckyAPI 本身已经针对国内网络优化,直连是最稳定的方案。


推荐配置总结

配置项推荐值说明
令牌分组auto自动选择最优路径
跨分组重试✅ 启用提高成功率
代理配置❌ 不使用国内直连更稳定

技术支持

如有问题,请访问 LuckyAPI 官网 获取支持,或查看 Claude Code 中文站 其他教程。


最后更新:2026-03-10

API 服务由 LuckyAPI 提供