> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibetoken.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 组织

> 团队共用一个钱包：邀请成员、为每个人分配自己的 API Key，并限制每位成员的消费额度。

**组织**是一个共享的计费账户。成员使用各自的**组织 API Key** 调用模型，每次请求都从**组织钱包**扣费，而不是从任何人的个人余额扣费。所有者和管理员可以看到谁花了多少，并为每位成员设置消费上限。

你的个人账户保持不变。个人 API Key、余额、用量和日志仍然是个人的，组织的活动不会出现在其中。

## 角色

| | 所有者 | 管理员 | 成员 |
| - | - | - | - |
| 创建并使用自己的 API Key | ✓ | ✓ | ✓ |
| 查看自己的用量和日志 | ✓ | ✓ | ✓ |
| 查看钱包余额 | ✓ | ✓ | ✓ |
| 查看所有成员的 API Key、用量、日志和账单记录 | ✓ | ✓ | |
| 邀请或移除成员，设置备注名和消费额度 | ✓ | ✓（不能管理其他管理员） | |
| 邀请或任命管理员，修改其他管理员 | ✓ | | |
| 向钱包转入或从钱包转出 | ✓ | | |
| 重命名组织 | ✓ | ✓ | |
| 转让所有权、解散组织 | ✓ | | |

每个组织只有一位**所有者**：创建组织的人，直到其转让所有权为止。任何人都不能修改自己的角色或把自己移除，请改用**退出**。所有者需先转让所有权才能退出。

## 创建组织

1. 打开账户菜单（头像），选择**创建组织**，或前往[设置 → 组织](https://vibetoken.cn/settings)。
2. 填写组织名称，你将成为该组织的所有者。
3. 通过头像菜单中的账户切换，在**个人**和你的各个组织之间切换。控制台页面（API Key、用量、日志、账单）显示当前所选账户的数据。

## 邀请成员

在组织的**成员**页面（[/team](https://vibetoken.cn/team)）点击**邀请**，填写一个或多个邮箱并选择角色。管理员可以邀请成员；只有所有者可以邀请管理员。

* 被邀请人可通过邮件中的链接接受邀请，也可在**设置 → 组织**中查看并接受待处理的邀请。
* 邀请与该邮箱绑定，只有**已验证邮箱**的账户才能接受。
* 邀请在 **7 天**后过期，在被接受前可以撤销。

## 为钱包充值

组织钱包与每位成员的个人余额相互独立。由**所有者**在组织的账单页面从自己的个人余额转入资金（也可以转回）。使用组织 API Key 的请求按与个人请求相同的模型价格从钱包扣费（见[定价](https://vibetoken.cn/pricing)）；个人折扣和个人 BYOK 凭据不会用于组织请求。

如果钱包余额不足以支付某个请求，该请求会被拒绝，返回 `402` 和 `Insufficient organization balance`，不会产生任何扣费。

## 消费额度

所有者和管理员可以在**成员**页面为每位成员设置四个可选额度：

| 额度 | 周期 |
| - | - |
| 总额 | 全部时间 |
| 每日 | 当前 UTC 自然日 |
| 每周 | 当前周，从周一 00:00（UTC）开始 |
| 每月 | 当前自然月（UTC） |

* 留空表示**不限额**；设为 `0` 表示该成员**完全不能消费**。
* 额度覆盖该成员**所有 API Key 的合计**，既计入已完成的请求，也计入仍在进行中的请求。
* 会让成员超出额度的请求在到达模型之前就被拒绝，返回 `402` 和类似 `Organization daily spend limit would be exceeded` 的消息，不会产生扣费。
* 成员页面会在额度旁显示每位成员的已用金额，计算方式与额度校验完全一致。

只有所有者可以修改管理员的额度，包括管理员自己的额度。

## 组织 API Key

在账户菜单中切换到该组织，然后照常在 **API Key** 页面创建。组织 API Key 的格式与个人 API Key 相同（`sk-rb-…`），同样放在 `Authorization: Bearer` 请求头中：

```bash theme={null}
curl https://vibetoken.cn/v1/chat/completions \
  -H "Authorization: Bearer $VIBETOKEN_ORG_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek/deepseek-v4-flash", "messages": [{"role": "user", "content": "Hello"}], "max_tokens": 256}'
```

* 组织由 API Key 本身决定。不要发送 `X-Organization-ID` 之类的组织请求头，带有这些请求头的请求会被拒绝。
* 消费记在创建该 API Key 的成员名下，并计入**该成员**的额度。如果希望成员额度相互独立，不要把一个成员的 API Key 给另一个成员使用。
* 只有 API Key 的创建者能再次查看完整的 Key。所有者和管理员能看到所有成员的 API Key（名称、前缀、创建者）并可以撤销，但永远看不到其完整内容。
* 成员退出或被移除时，其组织 API Key 会被撤销。

### 组织 API Key 目前能调用的接口

组织 API Key 目前仅支持 **[Chat Completions](/api-reference/chat-completions)**（`POST /v1/chat/completions`），并有以下限制：

* 每次请求一个模型（不支持模型数组），`n = 1`，**不支持流式**（`stream: true` 会被拒绝）。
* 仅支持文本消息，不支持图像或音频内容。
* 不支持 `tools` / `tool_choice` 及额外的供应商专属参数。
* `max_tokens` 介于 1 到 32768 之间（默认 4096）。

不支持的请求会返回 `400` 并说明原因，且不会扣费。图像、视频、音频、Embeddings、Responses API 和 Playground 目前请使用**个人** API Key。

## 用量、日志和账单

选中组织后，**API 用量**、**日志**和**账单**页面只显示该组织的活动：

* 成员看到自己的请求。
* 所有者和管理员能看到所有人的请求，可以用**成员**筛选查看某一个人，并能看到每个 API Key 的创建者和每笔扣费所属的成员。
* 账单记录（钱包转账和扣费）对所有者和管理员可见。

## 退出、转让和解散

* **退出**：除所有者外的任何成员都可以在组织设置页面退出。你的组织 API Key 将失效。
* **转让所有权**：所有者可以把另一位成员设为所有者，原所有者保留管理员身份。
* **解散**：钱包清空（先把余额转出）且没有进行中的请求后，所有者可以解散组织。其 API Key 将失效，历史记录会保留。

## 常见错误

| 状态码 | 消息 | 处理方式 |
| - | - | - |
| `401` | `Invalid organization key` | 该 Key 已被撤销、其创建者已离开组织，或组织已解散。请创建新的 Key。 |
| `402` | `Insufficient organization balance` | 请所有者为钱包充值。 |
| `402` | `Organization <total/daily/weekly/monthly> spend limit would be exceeded` | 等待周期重置，或请所有者/管理员提高你的额度。 |
| `400` | `Organization keys currently support single-model, non-streaming chat with n=1` | 去掉 `stream`，使用单个模型并设 `n = 1`，或改用个人 API Key。 |
| `400` | `Organization chat does not yet support tools or extra provider parameters` | 去掉 `tools` 或额外参数，或改用个人 API Key。 |
| `400` | `Organization scope is bound to the API key; scope headers are not accepted` | 去掉组织/账户相关请求头，Key 本身已经确定了组织。 |

通用的错误格式见[错误](/essentials/errors)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.