❓ 帮助中心(高频问题汇总)
常见问题
这里集中整理了用户接入时最常遇到的问题。建议优先查看与 Base URL、API Key、模型名、分组权限相关的内容。
常用入口
高频问题列表
Q1:返回“余额不足”怎么办?
先去钱包管理确认账户余额是否足够,再检查令牌本身是否单独设置了额度限制。
- 先看账户总余额是否大于 0
- 再看该令牌是否设置了单独额度上限
- 必要时查看使用日志,确认最近是否有高消耗调用
Q2:为什么模型调用失败,说模型不存在?
多半是因为你填写的 model 名称和模型广场展示的不一致。请直接复制站内模型名,不要手动改写。
- 不要自己删后缀
- 不要把别的平台模型名直接拿来用
- 以模型广场显示内容为准
Q3:为什么某些模型能在控制台看到,但令牌调用不了?
因为令牌可能绑定了分组限制,而该模型只允许特定分组访问。请检查令牌分组与模型分组要求是否一致。
- 模型可见,不等于令牌一定可调用
- 先看令牌所属分组
- 再看模型的分组限制说明
Q4:第三方客户端怎么填?
一般只需要填写 3 项:
- 接口地址:
https://api.fengsuan.online/v1 - API Key:你创建的
sk-xxx - 模型名:站内模型广场中的名称
注意:这里填写的是 Base URL,不是完整接口路径。请不要再额外拼接 /chat/completions。
通用填写模板
适用于大多数兼容客户端
Base URL: https://api.fengsuan.online/v1 API Key: sk-your-key Model: 站内模型广场中的模型名称
Q5:请求成功了,但扣费看起来不对?
请先到使用日志中查看该次请求的详细计费说明,里面会显示模型价格、倍率、输入输出 token 等信息。
- 先看请求对应的模型价格
- 再看是否有分组倍率
- 再看输入输出 token 或按次收费说明
Q6:我已经填了地址,为什么还是报错?
请优先检查 4 项:
- Base URL 是否填写为
https://api.fengsuan.online/v1 - API Key 是否正确,是否有多余空格
- 模型名是否与站内完全一致
- 令牌分组是否具备该模型的调用权限
建议顺序:先检查地址,再检查 Key,再检查模型名,最后检查余额和权限。大多数问题都集中在这几项。
Q7:可以直接兼容 OpenAI SDK 吗?
可以。只要将 base_url 设置为 https://api.fengsuan.online/v1,并使用你的 API Key 与站内模型名即可。
Python 示例
OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://api.fengsuan.online/v1"
)
resp = client.chat.completions.create(
model="gpt-4.1-mini",
messages=[
{"role":"user","content":"你好,请介绍一下你自己"}
]
)
print(resp.choices[0].message.content)
Q8:为什么我用同一个 Key,在一个客户端能用,在另一个客户端不能用?
通常不是 Key 本身的问题,而是两个客户端的 Base URL 填法、请求格式或者模型名填写方式不同。
- 先用 curl 或 OpenAI SDK 做最小化测试
- 确认服务本身可调用后,再检查第三方客户端配置
- 优先排查地址是否误填成根域名或完整接口路径