❓ 帮助中心(高频问题汇总)

常见问题

这里集中整理了用户接入时最常遇到的问题。建议优先查看与 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 做最小化测试
  • 确认服务本身可调用后,再检查第三方客户端配置
  • 优先排查地址是否误填成根域名或完整接口路径

遇到问题先看哪里