API Key 该在平台端发还是租户端发

LLMPod 里有两个地方能创建 API Key，菜单都叫“API Key”。但它们的数据范围不是一回事，选错会给后续留下一堆解释不清的账。

先说结论

给业务应用接入某个租户的模型服务，去那个租户的控制台创建 Key。管理员端创建的平台 Key 是平台域的，不按租户钱包扣费。

两个入口的区别

	平台直发 Key	租户 Key
创建入口	管理员端 → 开发者工具 → API Key	租户端 → 核心功能 → API Key
所属范围	平台域	当前租户
模型限制留空	所有已发布模型	当前租户可用的已发布模型
余额与封禁	不按租户钱包扣费，不校验租户封禁	受租户余额、模型封禁及租户状态约束

另外一点：API Key 用于访问推理网关，不用于登录管理控制台。这是两条不同的认证路径。

创建租户 Key 的完整流程

1. 租户端打开 核心功能 → 模型市场，确认目标模型已对当前租户开放，记下它的对外模型名称。
2. 打开 API Key → 创建 Key，填一个便于识别的名称，例如 production-service。
3. 在授权模型中选择允许调用的模型。
4. 按需要设置过期时间。
5. 在展开更多里设置 RPM、TPM、总 Token 配额和预算上限。
6. 创建并复制密钥，存到应用服务端的密钥管理里。

授权模型留空意味着什么

这里有个容易误解的地方。留空不等于这把 Key 能用平台上的所有模型，它指的是：

当前租户的全部可用模型，后续新开放的模型也会自动进入这个范围。

所以留空是“跟随租户可用范围动态扩大”，不是“锁定在创建那一刻”。

如果要固定访问范围，就得明确选择模型。选中一项后，这把 Key 不会自动覆盖其他模型。

授权模型的下拉框只列出当前租户可用的模型——看不到的模型，本来也调不到。

四项用量限制

在“展开更多”里可以设：

限制	作用
RPM	每分钟请求数
TPM	每分钟 Token 数
总 Token 配额	累计上限
预算上限	金额上限

空值表示该项不限。但“不限”不等于没有约束——仍然受租户余额、模型状态及平台规则限制。

密钥不是只显示一次

这一点和多数平台的习惯不同，值得单独说：

创建成功的弹窗会显示完整密钥。而当前版本的列表也会向有相应查看权限的管理端返回完整明文，界面中间省略显示并提供复制按钮。

也就是说，它不是“只在创建时显示一次”的凭据。因此：

• API Key 页面的查看权限要严格控制。
• 密钥不要放进浏览器代码、公开仓库或日志。
• 应用侧要用服务端的密钥管理，不要写进前端配置。

调整与停用

Key 列表可以查看授权模型、消费和状态，并提供调整、重置预算、禁用及删除。

一个管理侧的能力：管理员 API 可以指定 tenant_id 为某个租户签发 Key。但当前管理员界面的创建表单用的是平台域，界面上填不出租户归属。所以要给租户发 Key，还是在租户端操作更直接。

小结

选平台端还是租户端，看这一条就够：这笔用量该记在谁的账上、该受谁的封禁约束。

接入租户服务 → 租户端建 Key。做平台级运维或跨租户测试 → 平台 Key，但要清楚它不扣租户钱包，成本会落到别的口径上。