组织和成员
组织持有余额、API key 和用量。介绍如何创建和切换组织、邀请成员,以及每个角色能做什么。
何时阅读本页
用本页与团队共享余额和 key,用不同的组织把项目或客户分开,或者了解你的角色能做什么。
什么是组织
组织是 EZAT Router 中一切内容所在的地方:它的余额、API key、用量和付款。组织的成员共享这些内容。组织之间不共享任何东西:充到一个组织的额度不能用来支付另一个组织的请求,key 也总是从它所属的组织扣费。
一个人可以属于多个组织,在每个组织中的角色可以不同。
你的第一个组织
首次登录时会创建一个以你命名的组织(使用你的名字,或你邮箱地址的开头部分),你是它的所有者。它和其他组织一样:你可以给它改名,也可以邀请别人加入。如果当前有注册赠送额度,额度会发到这个组织,每人只发一次。
创建和切换组织
组织切换器在顶栏中,显示当前组织的名称。
- 切换:打开切换器,选择一个组织。之后每个页面(概览、API Key、用量、账单、设置)都会显示该组织的内容。控制台会在当前浏览器中记住你的选择。
- 创建:打开切换器,选择创建组织,输入名称并选择创建。你是它的所有者。新组织的余额为零,你可以在设置中邀请成员。你最多可以拥有 10 个组织。
要给组织改名,打开设置,在组织下修改名称并保存。同一张卡片中还会显示你的角色和组织 ID。就计费问题联系 support@ezat.io 时,请附上组织 ID。
角色
| 操作 | 所有者 | 管理员 | 财务 | 成员 |
|---|---|---|---|---|
| 查看余额、用量、成员和 API key 列表 | 是 | 是 | 是 | 是 |
| 创建 API key | 是 | 是 | 否 | 是 |
| 吊销 API key | 任何 key | 任何 key | 自己的 key | 自己的 key |
| 充值、查看付款记录和额度变动、设置余额提醒 | 是 | 是 | 是 | 否 |
| 给组织改名 | 是 | 是 | 否 | 否 |
| 邀请他人、更改角色、移除成员 | 是 | 是,所有者除外 | 否 | 否 |
| 把某人设为所有者,或者更改、移除所有者 | 是 | 否 | 否 | 否 |
| 退出组织 | 是,前提是还有其他所有者 | 是 | 是 | 是 |
邀请他人时,控制台是这样描述各个角色的:
- 所有者:完全控制,包括账单、成员和其他所有者。
- 管理员:管理成员、API Key 和账单,不能更改所有者。
- 财务:充值,查看付款和用量,不能创建 API Key。
- 成员:创建和使用 API Key、查看用量,看不到付款记录。
组织始终至少有一位所有者。如果你是最后一位所有者并想卸任,先把其他人设为所有者。
邀请他人
所有者和管理员可以通过邮箱邀请任何人:
- 打开设置。在成员下选择邀请。
- 输入对方的邮箱,选择一个角色,然后选择发送邀请。
- 邀请已创建中会显示邀请链接。EZAT Router 也会把链接通过邮件发出;如果邮件没有送达,复制链接自己发给对方。
关于邀请:
- 链接 7 天内有效,并且只对你填写的邮箱地址有效。
- 尚未接受的邀请列在待接受的邀请下,你可以选择用新链接重新发送或撤销。重新发送会替换链接,旧链接随即失效。
- 如果某个邮箱地址已有待接受的邀请,再次邀请会替换它,使用新的角色和新的链接。
- 一个组织最多可以有 50 个待接受的邀请。
接受邀请
- 打开链接。页面会显示哪个组织邀请了你、以什么角色,以及邀请发给哪个邮箱地址。
- 如果你还没有登录,选择登录后接受,并用受邀的邮箱地址登录。如果你还没有账户,会自动创建一个。
- 选择接受邀请。之后这个组织会出现在你的组织切换器中。
你必须用受邀的邮箱地址登录。如果你当前登录的是其他账户,选择换个账户登录。已过期或已撤销的链接无法使用:请让对方重新邀请你。
更改角色和移除成员
所有者和管理员在设置 → 成员中管理成员:
- 更改角色:在成员所在行选择新的角色。只有所有者能把某人设为所有者,或者更改、移除所有者。
- 移除成员:在成员所在行选择移除,然后选择移除。对方会立即失去访问权限。
被移除的成员创建的 API key 属于组织,会继续可用。如果它们不应继续使用,请在 API Key 页面吊销。
退出组织
打开设置,在退出组织下选择退出并确认。你会失去该组织的 key、余额和用量的访问权限;组织和它的 key 保持不变。之后要回来,需要新的邀请。
如果你退出了自己所属的唯一一个组织,下次使用控制台时,你会得到一个新的空组织。它的余额为零:注册赠送额度每人只发一次。
给 AI agent 的说明
- API key 属于某一个组织。key 总是从创建它的组织扣费,与用户之后在控制台中选中哪个组织无关。
- 如果请求返回
402,而用户说已经充值,问问他们是否充到了 key 所属的组织。 - 只有所有者、管理员和财务可以充值,而财务不能创建 key。告诉用户需要哪个角色,不要重试。