# 组织和成员

URL: https://docs.router.ezat.io/zh/organizations

> 组织持有余额、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、查看用量，看不到付款记录。

组织始终至少有一位所有者。如果你是最后一位所有者并想卸任，先把其他人设为所有者。

## 邀请他人

所有者和管理员可以通过邮箱邀请任何人：

1. 打开**设置**。在**成员**下选择**邀请**。
2. 输入对方的**邮箱**，选择一个**角色**，然后选择**发送邀请**。
3. **邀请已创建**中会显示**邀请链接**。EZAT Router 也会把链接通过邮件发出；如果邮件没有送达，复制链接自己发给对方。

关于邀请：

- 链接 7 天内有效，并且只对你填写的邮箱地址有效。
- 尚未接受的邀请列在**待接受的邀请**下，你可以选择**用新链接重新发送**或**撤销**。重新发送会替换链接，旧链接随即失效。
- 如果某个邮箱地址已有待接受的邀请，再次邀请会替换它，使用新的角色和新的链接。
- 一个组织最多可以有 50 个待接受的邀请。

### 接受邀请

1. 打开链接。页面会显示哪个组织邀请了你、以什么角色，以及邀请发给哪个邮箱地址。
2. 如果你还没有登录，选择**登录后接受**，并用受邀的邮箱地址登录。如果你还没有账户，会自动创建一个。
3. 选择**接受邀请**。之后这个组织会出现在你的组织切换器中。

你必须用受邀的邮箱地址登录。如果你当前登录的是其他账户，选择**换个账户登录**。已过期或已撤销的链接无法使用：请让对方重新邀请你。

## 更改角色和移除成员

所有者和管理员在**设置** → **成员**中管理成员：

- **更改角色**：在成员所在行选择新的角色。只有所有者能把某人设为所有者，或者更改、移除所有者。
- **移除成员**：在成员所在行选择移除，然后选择**移除**。对方会立即失去访问权限。

被移除的成员创建的 API key 属于组织，会继续可用。如果它们不应继续使用，请在 **API Key** 页面吊销。

## 退出组织

打开**设置**，在**退出组织**下选择**退出**并确认。你会失去该组织的 key、余额和用量的访问权限；组织和它的 key 保持不变。之后要回来，需要新的邀请。

如果你退出了自己所属的唯一一个组织，下次使用控制台时，你会得到一个新的空组织。它的余额为零：注册赠送额度每人只发一次。

## 给 AI agent 的说明

1. API key 属于某一个组织。key 总是从创建它的组织扣费，与用户之后在控制台中选中哪个组织无关。
2. 如果请求返回 `402`，而用户说已经充值，问问他们是否充到了 key 所属的组织。
3. 只有所有者、管理员和财务可以充值，而财务不能创建 key。告诉用户需要哪个角色，不要重试。