使用 Taotoken 管理多个项目 API Key 与访问权限控制
1. 创建 API Key 与基础配置
在 Taotoken 控制台中，团队管理员可以通过以下步骤创建和管理 API Key。登录后进入「API 密钥」管理页面，点击「新建密钥」按钮生成新 Key。系统会返回一个以sk-开头的字符串，这是后续调用 API 的凭证。
创建 Key 时可设置以下基础属性：
- 名称：建议使用项目或用途命名（如
frontend-prod） - 有效期：可选择永久或自定义过期时间
- 备注：记录 Key 的使用场景或负责人
密钥生成后请立即复制保存，页面刷新后将无法再次查看完整密钥。
2. 绑定项目与访问控制
每个 API Key 可以绑定到特定项目，实现资源隔离。在密钥详情页的「项目绑定」选项卡中，可以勾选该 Key 有权访问的项目。未绑定的项目将无法通过此 Key 调用相关模型。
访问控制规则支持以下维度配置：
- 模型白名单：限制该 Key 只能调用指定的模型（如仅允许使用
claude-sonnet-4-6） - 额度限制：设置每日/每月最大 Token 消耗量
- IP 白名单（可选）：限制仅特定 IP 段可调用此 Key
3. 查看调用记录与审计
Taotoken 提供完整的调用日志功能，管理员可以在「审计日志」页面查看所有 API 请求记录。支持按以下条件筛选：
- 时间范围（最近 1 小时/24 小时/7 天/自定义）
- 特定 API Key
- 项目名称
- 模型类型
- 响应状态码
每条记录包含请求时间、消耗 Token 数、所用模型和响应延迟等关键信息。日志数据可导出为 CSV 格式供进一步分析。
4. 多环境 Key 管理实践
对于需要区分开发、测试和生产环境的企业，建议采用以下管理策略：
- 为每个环境创建独立 Key（如
dev-key、staging-key、prod-key） - 开发环境 Key 绑定低成本模型并设置低额度限制
- 生产环境 Key 启用 IP 白名单并绑定高稳定性模型
- 定期轮换测试环境 Key（建议每月更新）
5. 团队协作注意事项
当多个成员需要共享 Key 时：
- 避免直接分发主账号密钥
- 为每个成员创建子 Key 并绑定其负责的项目
- 离职或转岗成员关联的 Key 应及时停用
- 关键操作建议开启二次验证
所有权限变更操作都会记录在审计日志中，包括 Key 的创建、修改和删除事件。
如需开始使用 Taotoken 的团队权限管理功能，请访问 Taotoken 控制台。
