跳到主要内容

模型与令牌分组介绍

令牌分组决定一个 API Key 可以使用的模型、协议和客户端。直接选择具体分组时,这把 Key 只按所选分组调用;如果暂时不知道该选哪个分组,请先查看模型广场中的 Auto 说明。

如何查看模型广场​

文档内的模型广场会实时显示当前可用模型、令牌分组和接口类型。也可以登录 APINebula 后点击顶部导航中的 模型广场,或直接打开 APINebula 官网模型广场查看完整价格信息。

查看模型广场

查看时重点确认:

  • 要使用的模型名称
  • 模型支持的令牌分组
  • 客户端需要使用的接口类型

视频教程:认识模型分类与分组​

下面的视频介绍模型分类与令牌分组的区别。当前可用模型、分组和价格请以实时模型广场为准。

先看模型,再创建令牌​

模型广场中的“可用令牌分组”表示模型与令牌权限的对应关系:

  1. 搜索要调用的模型。
  2. 查看该模型支持的令牌分组和接口类型。
  3. 创建 API 令牌时选择同名分组。
  4. 模型可用列表 建议留空;如果填写,必须包含实际调用的模型,否则可能返回 403。

倍率与费用​

先分清两件事:充值是增加可用额度,调用模型是消耗可用额度。

看到的内容应该怎样理解
钱包管理页面的到账额度充值后实际增加到账户中的可用额度,以页面显示为准。
模型广场的价格调用对应模型并使用对应令牌分组时,系统用于扣费的最终参考价格。
令牌分组倍率在基础价格上调整费用的系数,只影响扣费,不代表模型能力、速度或稳定性。

倍率怎么算​

平台统一把官方 API 标价中的 1 美元按 1 元计入网站基础价格,再乘以令牌分组倍率。该规则只用于模型价格折算,不是充值兑换规则,也不是实时汇率。

例如官方 API 标价为 1 美元,网站基础价格按规则折算为 1 元;令牌分组倍率为 0.5x 时,对应价格就是 1 元 × 0.5 = 0.5 元。

模型广场显示的价格已经完成基础价格折算和分组倍率计算,无需自行换算美元,也不要再次乘以倍率;具体计费单位和当前价格以模型卡片为准。

常见作用​

  • 按环境隔离权限
  • 按团队隔离调用范围
  • 为生产密钥设置更严格的限制

推荐做法​

  • 测试环境与生产环境使用不同的 API Key
  • 为不同服务创建不同的密钥
  • 定期轮换高权限密钥

模型可用列表​

创建令牌时,建议将 模型可用列表 留空。填写后令牌只能调用列表中的模型;若列表中不包含当前使用的模型,请求可能返回 403 或提示无权限。只有需要明确限制模型范围时,才填写完整且准确的模型名称。

微信扫码联系我们