常见问题

Q1: 调用返回 401 Unauthorized

按概率排查:

  1. Authorization: Bearer sk-xxx 写法对吗?不能丢 Bearer 前缀,中间一个空格
  2. Key 是不是被你删了?(后台 API 密钥列表找一下)
  3. IP 白名单是不是限制了?(留空 = 不限)
  4. 是不是禁用了这个 Key?
  5. Key 过期了?

Q2: 调用返回 404 Not Found 或 model not found

分组跟模型不匹配:

  • 用 GPT 池的 Key 调 claude-* → 404
  • 用 Claude 池的 Key 调 gpt-* → 404
  • 用 gemini 池的 Key 调 claude-* 或 gpt-* → 404

解决:重新建一个对应分组的 Key,或者改 model 名。见 选择分组。

Q3: 调用返回 403 Insufficient balance

钱包余额不够支付这次请求的预估费用。Claude / GPT-5 / gpt-image-2 单次可能 ¥0.5 - ¥5,提前充够。

充值入口:顶部余额胶囊 → 充值,或者 钱包页面。

Q4: 调用返回 429 Too Many Requests

被限流了,两种可能:

原因处理
分组 RPM 限制同一分组所有 Key 共用一个 RPM,等几秒重试
网关短时拥塞网关自动切换路由,通常 1-2 秒内自愈,重试即可
全池都被限等几分钟,或者切到另一个分组

Q5: 生图失败 / 返回 "Tool choice 'image_generation' not found"

现象原因
全部生图请求失败用了 gpt(无生图) 分组的 Key — 这个分组不支持稳定生图
偶尔失败上游某次未返回有效图片,网关会自动换路重试,多试几次
401Key 写错或被删

解决:用 GPT 分组的 Key 生图。

Q6: Claude Code 一直问要登录 / Login required

~/.claude/settings.json 路径或格式错了。检查:

  1. 路径对不对?Windows 在 %USERPROFILE%\.claude\settings.json
  2. JSON 格式有没有写错(用 https://jsonlint.com 验证)
  3. 重启 terminal(环境变量改了的话)

完整配置见 Claude Code CLI 文档。

Q7: 充值没到账

  1. 等 1 分钟刷新
  2. 进「钱包 → 订单」看状态
  3. 状态显示「已支付,未到账」→ 把订单号截图发微信 Yeesleeve

Q8: 速度慢 / 长时间无响应

情况处理
流式回复几秒后才出第一个 token正常,大模型加载需要时间
完全无响应 30 秒+可能是网络问题,F5 或者换分组试试
国内访问慢检查不要被本地 hosts / VPN 错误劫持,Miloapi 域名走 CDN

Q9: 我能拿到发票吗?

可以,联系微信 Yeesleeve 申请,提供:

  • 抬头(公司全称或个人)
  • 税号(公司发票必填)
  • 邮箱(电子发票发到这里)

Q10: 一个账号能开几个 Key?

不限。建议按用途隔离:

  • claude-code-工作
  • cursor-个人
  • cherry-studio-测试
  • 脚本-限额-5刀

这样泄露 / 滥用容易定位。

Q11: 怎么注销账号?

个人中心 → 安全设置 → 注销账号。

⚠️ 不可撤销,会清空:

  • 所有 API Key
  • 余额(不会退款)
  • 对话历史
  • 订单记录

如果只是想停用一段时间,不要注销,改成停用所有 Key 即可。

Q12: 网站打不开

  1. 国内访问 www.miloapi.com 应该是直连
  2. 看 DNS:ping www.miloapi.com 应该能 ping 通
  3. 不行的话,直接发微信 Yeesleeve,可能是临时维护

Q13: 安全自检清单

定期检查(建议每月):

  • [ ] 后台 2FA 开了
  • [ ] 没用的 Key 删掉了
  • [ ] 生产 Key 加了 IP 白名单
  • [ ] 不可信脚本用的 Key 设了额度上限
  • [ ] 没把 Key commit 进 Git(可以用 trufflehog 扫一下历史)
  • [ ] Claude Code / Codex / Cursor 等本地配置文件没在共享网盘里

联系支持