模型与令牌分组说明
令牌分组决定一个 API Key 可以使用哪些模型、协议和客户端。
直接选择具体分组时,这把 Key 只按所选分组调用;如果暂时不知道该选哪个分组,可以看下面的「Auto」说明。
先看模型,再创建令牌
模型广场中的「可用令牌分组」表示模型与令牌权限的对应关系:
- 搜索要调用的模型
- 查看该模型支持的令牌分组和接口类型
- 创建 API 令牌时选择同名分组
- 「模型可用列表」建议留空;如果填写,必须包含实际调用的模型,否则可能返回 403
:::danger 不要凭名字猜分组
default 不是通用分组。用什么模型,就选该模型支持的分组。
:::
倍率与费用
先分清两件事:充值是增加可用额度,调用模型是消耗可用额度。
| 你看到的内容 | 应该怎样理解 |
|---|---|
| 钱包页面的到账额度 | 充值后实际增加到账户的可用额度,以页面显示为准 |
| 模型广场的价格 | 调用对应模型 + 对应分组时,系统用于扣费的最终参考价格 |
| 令牌分组倍率 | 在基础价格上调整费用的系数,只影响扣费,不代表模型能力、速度或稳定性 |
倍率怎么算
平台统一把官方 API 标价中的 1 美元按 1 元计入网站基础价格,再乘以令牌分组倍率。
例:官方 API 标价 1 美元 → 网站基础价格 1 元;分组倍率 0.5x → 实际 1 × 0.5 = 0.5 元。
提示
模型广场显示的价格已经完成基础价格折算和分组倍率计算。 无需自行换算美元,也不要再次乘以倍率。
分组的常见作用
- 按环境隔离权限
- 按团队隔离调用范围
- 为生产密钥设置更严格的限制
推荐做法
- 测试环境与生产环境使用不同的 API Key
- 为不同服务创建不同的密钥
- 定期轮换高权限密钥
模型可用列表
创建令牌时建议留空。
填写后令牌只能调用列表中的模型;若列表中不包含当前使用的模型,请求会返回 403 或提示无权限。
信息
只有需要明确限制模型范围时,才填写完整且准确的模型名称。
常见分组类型
| 分组 | 用途 |
|---|---|
default | 默认分组 |
vip | 专属分组,倍率可能更低 |
auto | 自动路由分组,见 Auto 分组令牌 |
| 图片/视频专用分组 | 按模型能力划分,见 模型广场 |
信息
具体分组名以控制台实际显示为准,不同模型支持的分组不同。
相关:模型广场 · Auto 分组令牌 · 创建 API 令牌 · [常见问题]../reference/faq/overview