Higan API

常见问题

注册与登录

注册提示「需要邀请码」

正常。本服务不开放自由注册,向管理员索取邀请码。 详见 注册与登录。

收不到邮箱验证码

  1. 先查垃圾邮件 / 广告邮件文件夹
  2. 确认邮箱地址没写错
  3. 等 1–2 分钟,部分服务商投递较慢
  4. 仍然收不到 → 说明本站 SMTP 未配置好,直接找管理员

GitHub 登录报错

提示含义
redirect_uri mismatch本站的 GitHub 回调地址配置有误,找管理员
登录后邮箱为空你的 GitHub 账号没设公开邮箱,去 GitHub 设置里补一个并验证
要求填邀请码正常,邀请码注册开着

忘记密码

登录页点忘记密码,填注册邮箱收重置链接(需要本站配好 SMTP)。 如果邮箱也忘了或收不到邮件,找管理员手动重置。

报错排查

401 Unauthorized

密钥错误或未携带。

  • 确认请求头是 Authorization: Bearer sk-xxx(OpenAI 兼容) 或 x-api-key: sk-xxx(Anthropic 兼容)
  • 确认密钥没被删除或过期
  • 确认没有把面板登录密码当成密钥使用

403 Forbidden

账号被禁用,或密钥被限制访问该分组。联系管理员。

429 Too Many Requests

触发了速率或并发限制。

  • 降低并发数,或给请求之间加退避重试
  • 如果长期需要更高并发,可兑换并发卡
  • 上游账号限流也会表现为 429,重试通常可恢复

402 / 额度不足

余额或套餐已耗尽。兑换新卡密后立即恢复。

请求一直无响应 / 最后一次性返回全部内容

这是流式响应被中间层缓冲的典型症状。

  • 如果你自己架了 Nginx 反代,需要关闭 proxy_buffering
  • 检查客户端是否开启了流式(stream: true)
  • 使用企业级代理/VPN 也可能造成缓冲

连接超时 / 无法访问

先用 curl 在终端验证:

curl -sS -o /dev/null -w '%{http_code}\n' https://api.higanai.top/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

200 说明服务正常,问题在客户端配置。

服务条款

  • 本服务为个人/小范围自建共享服务,非 OpenAI、Anthropic、Google 等厂商的 官方产品或授权代理,与上述公司无任何关联。
  • 服务按现状提供,不承诺可用性 SLA,不承诺数据持久性。
  • 请勿用于任何违反上游服务商条款或当地法律法规的用途。
  • 管理员保留在不事先通知的情况下调整价格、模型列表与服务范围的权利。
  • 恶意刷量、转售、共享密钥给非授权人员,可能导致账号被立即停用且不退款。

隐私说明

  • 请求会经由本服务中转,因此会经过本服务的服务器。
  • 默认不持久化存储你的提示词与模型回复全文;仅记录用于计费的元数据 (token 数、模型、状态码、耗时、时间戳)。
  • 为排查故障,错误请求的少量上下文可能被短期保留。
  • 请不要在请求中提交身份证号、银行卡号、密码等敏感个人信息。
  • 需要删除账号及相关数据,请联系管理员。

还是解决不了?

把以下信息发给管理员:

  1. 出错的时间点(精确到分钟)
  2. 使用的客户端与配置(Base URL、模型名)
  3. 完整报错信息(记得打码你的密钥)