Appearance
Kimi 开放平台的组织体系支持多项目隔离、独立消费预算和精细权限管理。企业用户通过组织认证后可解锁更高项目数和 API Key 配额,并为每个项目单独设置日/月消费预算和 TPM 限速。本文是面向企业团队使用 Kimi API 的配置手册。
Kimi API 组织管理最佳实践
组织与项目的关系
| 层级 | 说明 |
|---|---|
| 组织 | 顶层单位,持有余额、限速配额、成员资格 |
| 项目 | 业务隔离单位,每个项目有独立的 API Key 和消费预算 |
| API Key | 属于项目,用于区分业务系统或环境(如 prod/staging) |
所有项目共享组织的限速(RPM/TPM)和余额,但可以为每个项目单独设置消费预算上限。
认证级别与配额
| 认证级别 | 最大项目数 | 最大 API Key 数 |
|---|---|---|
| 未认证 | 1 | 10 |
| 个人认证 | 20 | 50 |
| 企业认证 | 50 | 100 |
| 企业级 API 用户 | 100 | 200 |
企业认证后还可以申请更高的限速(TPM/RPM)额度,并获取免费代金券。
项目消费预算配置
在项目设置中可以设置:
- 月消费预算:整月内总消费上限
- 日消费预算:每天消费上限
超出预算后该项目的 API 请求会被拒绝(错误码 budget_exceeded)。注意:预算限制有约 10 分钟的延迟,不能完全精确控制。
消费告警
在「消费提醒」中设置短信告警阈值,超额后会通知组织管理员。适合团队监控异常调用(如 Agent 失控、重试循环导致的超额消耗)。
TPM 单独配置
可以为特定项目单独设置 TPM(每分钟 token 数)限速,适合控制低优先级批处理任务的占用:
- 项目 TPM 上限不能超过组织 TPM 总量
- 在项目设置的「限速」页面配置
成员权限
| 角色 | 权限 |
|---|---|
| 企业管理员 | 管理项目、成员、发票 |
| 项目管理员 | 管理预算、限速、消费通知、成员、API Key |
| 项目成员 | 新建 API Key |
成员被移出项目后,其创建的 API Key 会立即失效。
常见问题
Q: 组织下多个项目的 API 请求是否互相影响?
A: 共享限速,但消费预算独立。如果一个项目发起大量请求触发 TPM 限速,会影响同一组织下的其他项目。建议为关键项目单独设置较高的 TPM 配额,并为低优先级项目设置 TPM 上限。
Q: 如何查找组织 ID?
A: 登录 platform.kimi.com,进入「组织管理」→「组织认证」页面,企业认证后可查看组织 ID 和名称。
Q: 项目删除后 API Key 还能用吗?
A: 不能。删除项目后,该项目下的所有 API Key 立即失效,相关历史请求记录也无法通过控制台查看。删除前请确保备份必要的 Key 或迁移到其他项目。