主题
团队协作
Zivv 团队用于统一管理成员、API Key、预算和用量。团队 Key 的消费从 Owner 的个人余额 扣除，不需要维护独立团队钱包。
适合哪些场景
- 多名开发者共同使用 AI 编程工具
- 为不同成员分配独立 Key 并追踪消费
- 设置团队日 / 月 / 总额预算，避免意外超支
- 按成员、Key、模型查看用量与成本
五步开始使用
1. 创建团队
登录控制台，在右上角上下文切换器中选择 创建团队，填写团队名称。创建者自动成为 Owner。
2. 邀请成员
进入团队设置的成员页面：
- 按邮箱批量邀请
- 或生成邀请链接分享
- 为受邀者指定成员或管理员角色
- 按需设置邀请有效期
3. 设置预算和速率
在用量配额中设置：
- 团队每日预算
- 团队每月预算
- 团队总预算
- 团队 RPM 上限
- 单个成员的消费子预算
任一预算触顶时，相关请求会返回团队或成员预算错误，避免继续扣费。
4. 分发团队 Key
由 Owner 或管理员创建团队 Key，并绑定到具体成员。一个 Key 对应一个成员，便于追踪和回收。
团队 Key 同样可以配置：
- 模型分组和模型白名单
- RPM / RPH
- 额度上限
- 过期时间
5. 查看用量
切换到团队上下文后，在用量页面按成员、Key、模型查看排行和明细。团队消费实时从 Owner 余额扣除。
角色与权限
| 操作 | Owner | 管理员 | 成员 |
|---|---|---|---|
| 管理团队信息 | ✓ | ✓ | — |
| 邀请或移除成员 | ✓ | ✓ | — |
| 变更成员角色 | ✓ | — | — |
| 创建和管理团队 Key | ✓ | ✓ | — |
| 使用分配给自己的 Key | ✓ | ✓ | ✓ |
| 查看全部团队用量 | ✓ | ✓ | — |
| 查看个人用量 | ✓ | ✓ | ✓ |
| 修改预算与团队 RPM | ✓ | — | — |
| 解散团队 | ✓ | — | — |
计费规则
一个钱包管理团队
团队没有独立余额。所有团队 Key 消费直接从 Owner 的个人余额扣除，Owner 在 钱包 充值即可。
一次团队请求会依次检查：
- Owner 余额是否可用
- 团队日 / 月 / 总预算是否充足
- 成员子预算是否充足
- Key 自身额度、模型权限和速率限制是否允许
成员离开或被移除
成员被移除后，其名下团队 Key 会自动禁用。仍建议管理员检查 Key 列表和用量日志，确认没有需要重新分配的自动化任务。
常见错误
| 错误 | 含义 | 处理方式 |
|---|---|---|
team daily budget exceeded | 当日团队预算已用尽 | Owner 调整预算或等待次日重置 |
team monthly budget exceeded | 当月团队预算已用尽 | Owner 调整预算或等待下月重置 |
team total budget exceeded | 团队总预算已用尽 | Owner 提高总预算 |
member budget exceeded | 当前成员子预算已用尽 | Owner 调整成员预算 |
insufficient balance | Owner 个人余额不足 | Owner 前往钱包充值 |
更多错误见 错误码。