常见问题 (FAQ)

计费模式与分组使用

1. 计费模式

白菜上游供应API 全站采用纯按量计费（Pay-as-you-go）机制，无任何月卡、强制套餐或定期过期限制：

余额永久有效：充值任意金额，额度不过期、不清零；
按真实消耗扣费：仅在实际发起 API 请求并成功返回 Token 时按对应分组倍率扣费，不调用绝不扣除任何费用。

2. 如何选择与切换服务分组？

平台针对不同业务场景与网络通道划分了专属服务分组（如「默认组」、「高并发组」、「官转稳定组」等）：

创建新密钥：在控制台创建 API Key 时，直接在「分组」下拉框中选择所需分组即可；
修改已有密钥：在 API Key 列表中点击该密钥的分组标识，即可在下拉菜单中随时一键无感切换，无需更换密钥本身。

如何查看模型价格？

登录控制台后，进入 「模型广场 / 定价列表」 页面，即可实时查看所有支持模型的：

官方基准单价；
平台折后实付单价（按 1M Token 计费）；
缓存命中折扣单价与实时计费倍率。

为什么会使用其他模型？

某些前端客户端工具（如 Cherry Studio、Chatbox、NextChat 等）在特定场景下会静默发起轻量辅助调用，例如：

自动生成对话标题；
提炼和压缩长会话上下文记忆；
对上下文输入进行安全分类。

这类辅助请求往往会调用更轻量的辅助模型，属于客户端配置的正常行为，并非平台替您更换了主模型。

接口调用常见报错与排障

1. 提示 `401 Unauthorized` / `Invalid API Key`

原因：请求头中的 Authorization 缺少 Bearer 前缀，或使用了已停用/已删除的 API Key；
排查：确认请求头为 Authorization: Bearer sk-xxxx，并在控制台确认该密钥处于启用状态且余额充足。

2. 提示 `429 Too Many Requests`

原因：并发调用频率超过了当前 Key 或所在分组的速率上限；
排查：检查客户端并发脚本，大批量调用需求请联系官方 QQ 群（429199358）群主调整并发额度。

3. 提示 `504 Gateway Timeout`

原因：模型生成超长思考内容或上游网络突发毛刺；
排查：建议客户端请求时开启流式传输（stream: true）并在网络库中设置合理的超时时间（建议 120s 以上）。

使用协议与政策在哪里？

本平台所有规范与合规文件均已公开：