# 常见问题 FAQ --- ## 注册 / 账号 ### Q: 我是新用户应该怎么开始？ 跟着 [快速开始](/docs/onboarding/quickstart) 6 步走，10 分钟拿 key + 跑通工具。 ### Q: 收不到验证码？ 1. 检查邮箱垃圾箱 / 广告分类 2. 登录页点 "重新发送验证码" 3. 仍然没有 → 联系在线客服处理 ### Q: 想换登录邮箱？ 控制台 → 个人设置 → 改邮箱（需要二次验证）。 ### Q: 忘记密码？ 登录页 → "忘记密码" → 邮箱重置链接。OAuth (Google/GitHub) / Passkeys 用户直接走原认证。 ### Q: 我能不能用 Passkey 免密登录？ 可以，控制台 → 个人设置 → "WebAuthn / Passkeys" → 添加。iPhone Face ID / Mac Touch ID / 1Password / YubiKey 都支持。强烈推荐，防钓鱼 + 免输密码。 --- ## 充值 / 余额 ### Q: 充值后多久到账？ 支付宝一般 30 秒内到账。10 分钟没到 → 联系在线客服处理。 ### Q: 可以退款吗？ 可以，联系在线客服说明订单和账号即可。 ### Q: 怎么看消费明细？ 控制台 → 日志 → 每条记录：时间 / 模型 / 输入 token / 输出 token / 扣费金额。 也能按 token / 模型 / group 过滤。 ### Q: 怎么导出消费记录？ 控制台 → 日志 → 右上 "导出" → 选时间范围 → 下载 CSV。 ### Q: 余额能不能转给别人？ 不能，钱包绑定账号。共用同一钱包请共用账号（但生产建议团队各自注册，下面 Q 看怎么给团队建多 key）。 --- ## 令牌 / API key ### Q: 怎么给团队不同人发 key 但共用余额？ 注册 1 个账号 → 创建多个令牌（每个名字不同，比如 `alice-claude-code` / `bob-codex`）→ 发给团队。所有令牌共用钱包余额。 缺点：看不到谁花了多少。建议团队大就各自注册。 ### Q: key 泄露了怎么办？ 控制台 → 令牌 → 删掉那个 key → 新建一个。删除后立即失效，原 key 后续请求会 401。 ### Q: 可以限制 IP 白名单吗？ 可以。控制台 → 令牌 → 编辑 → "IP 白名单"。多个 IP 用逗号分隔。 ### Q: 我能限制单 key 用多少额度吗？ 可以。控制台 → 令牌 → "额度" 字段。设 `0` = 不限（用完钱包余额）。 ### Q: 令牌过期了？ 控制台 → 令牌 → 编辑 → 改 "过期时间"。默认永不过期。 --- ## 模型 / 分组 ### Q: gpt-vip 分组怎么不能用了？ `gpt-vip` 是老分组。新建令牌选 `gpt-plus` 或 `gpt-pro`： - `gpt-plus`：覆盖日常 GPT / Codex 场景，**大多数人选这个** - `gpt-pro`：高阶 GPT 资源池，适合长上下文、记忆和重度任务 具体价格配置以 **模型广场** 当前展示为准。 ### Q: claude-vip 和 claude 特惠区别？ - `claude-vip`：Claude 全量资源池，通常包含 opus / sonnet / haiku - `claude 特惠`：Claude 常用资源池，通常覆盖 sonnet / haiku，不含 opus 日常用 sonnet/haiku → 优先看 `claude 特惠`。要 opus → 看 `claude-vip`。具体可用模型和价格以 **模型广场** 当前展示为准。 ### Q: 我能不能两个 group 都用？ 可以。建两个令牌： - `claude-code-mac` 选 `claude-vip` → 给 Claude Code 用 - `codex-mac` 选 `gpt-plus` → 给 Codex 用 ### Q: 怎么知道当前 group 有哪些模型？ https://beefapi.com → 顶部 nav "**模型广场**" → 左侧选 group → 右侧显示该 group 包含的所有模型、实时价格配置和描述。 ### Q: model_not_found 404 怎么办？ 99% 是 group 选错了。详见 [分组与模型](/docs/onboarding/groups-models) + [错误码排查](/docs/onboarding/errors)。 --- ## 工具配置 ### Q: Claude Code 配完报 401 / "Unable to connect to Anthropic services" 最常见原因： 1. `~/.claude/settings.json` 里 `ANTHROPIC_BASE_URL` 没设成 `https://beefapi.com`（默认是 `api.anthropic.com` 被墙） 2. 用了 `ANTHROPIC_API_KEY` 而不是 `ANTHROPIC_AUTH_TOKEN` 3. 加了 `/v1` 后缀（**不要加**） 详细修法见 [错误码排查 → "Unable to connect"](/docs/onboarding/errors)。 ### Q: Codex 配完没反应 / 401 检查 `~/.codex/config.toml` 和 `~/.codex/auth.json` 两个文件都存在 + 配置对。`auth.json` 里 key 是 `OPENAI_API_KEY` 不是 `OPENAI_AUTH_TOKEN`。 base_url 必须是 `https://beefapi.com/v1`（**加 `/v1`**）。 ### Q: 我能不能用其他 OpenAI Compatible 客户端？ 可以，走 OpenAI Compatible 手动配置： - Base URL：`https://beefapi.com/v1` - API Key：你的 `sk-xxx` - Model：`gpt-5.5` / `gpt-5.4` / 你的目标模型 Claude Code / Claude Desktop / Codex / Hermes 优先用 CC Switch；Hermes 会按 Chat Completions 导入，BeefAPI 已兼容正常对话。其他客户端直接填 Base URL 和 Key。 ### Q: gpt-image-2 / Image2 怎么接？ Image2 按 OpenAI Images API 配： - Base URL：`https://beefapi.com/v1` - Endpoint：`POST /v1/images/generations` - Model：`gpt-image-2` - 令牌 group：`gpt-plus` 或 `gpt-pro` - `n` 不填或填 `1` 详细示例见 [客户端配置 → Image2 / gpt-image-2](/docs/onboarding/clients)。 ### Q: 1M context 和 200K 区别？ Claude Code 默认开 1M context，能塞超长上下文但偶尔抽风 / 慢。 要切回 200K（更稳）：`settings.json` env 加 `"CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"`。 ### Q: Codex 越用越笨 / 降智？ 不是模型降级，是用法问题。详见 [错误码排查 → Codex 降智](/docs/onboarding/errors)。 要点：拆任务 + 别压缩 + 60% 上下文上限 + 写好 `AGENTS.md` 全局指南。 ## 网络 / 代理 ### Q: 我开了梯子能用吗？ 可以。但部分请求可能被代理劫持失败。建议： - 把 `beefapi.com` 加入梯子白名单（不走代理直连） - Clash 用户：把 MTU 改 1500（默认有时太小） ### Q: 报 "Connection failed" / SSL error 通常是本机网络 / 代理问题。先： 1. 关梯子重试 2. `curl https://beefapi.com/api/status` 测连通 3. 仍不行 → 联系在线客服并带上完整报错 --- ## 计费 / 价格 ### Q: 一个月大概花多少钱？ 完全看用量、模型、上下文长度和输出 token，不建议按文档里的固定金额估算。 你可以这样判断： 1. 在 **模型广场** 看当前模型和 group 的实时价格配置。 2. 先小额使用几次。 3. 到 **控制台 → 日志** 看每次请求的实际扣费，再按自己的使用频率估算月用量。 ### Q: 价格怎么算？ 实际扣费由 **模型价格、分组价格配置、输入/输出用量** 共同决定。不要按文档里的历史数字估算，直接看 **模型广场** 当前价格配置；每次请求的实际扣费在 **控制台 → 日志** 里查看。 ### Q: 我能不能预付费包月？ 目前主要是按量充值。如需团队或企业方案，可以联系在线客服。 --- ## 其他 ### Q: BeefAPI 是谁做的？跑路风险？ 独立团队长期运营。详细问题可以联系在线客服。 ### Q: 数据安全？聊天会被存吗？ - BeefAPI 不存对话内容 - 仅存 metadata（模型 / token 数 / 时间 / 扣费）做账单 / 日志 - key 加密存数据库 - 部分上游可能存（OpenAI / Anthropic 自己），看具体上游 ToS ### Q: 能不能私有部署？ 联系在线客服，说明具体需求和使用规模。 ### Q: 联系方式 - QQ 群：**912022855**（加群后私信群主，领取5 元体验额度） - 邮件反馈：进控制台 → 个人设置 → "联系客服" --- ## 没找到答案？ 联系在线客服时，带上： - 你用什么工具（Claude Code / Codex / Cherry Studio / ...） - 你的 base URL + group + model - 报错完整截图 / JSON - 你已经尝试过的修复步骤 信息越完整，定位越快。