角色
每个组织只有一位所有者:创建组织的人,直到其转让所有权为止。任何人都不能修改自己的角色或把自己移除,请改用退出。所有者需先转让所有权才能退出。
创建组织
- 打开账户菜单(头像),选择创建组织,或前往设置 → 组织。
- 填写组织名称,你将成为该组织的所有者。
- 通过头像菜单中的账户切换,在个人和你的各个组织之间切换。控制台页面(API Key、用量、日志、账单)显示当前所选账户的数据。
邀请成员
在组织的成员页面(/team)点击邀请,填写一个或多个邮箱并选择角色。管理员可以邀请成员;只有所有者可以邀请管理员。- 被邀请人可通过邮件中的链接接受邀请,也可在设置 → 组织中查看并接受待处理的邀请。
- 邀请与该邮箱绑定,只有已验证邮箱的账户才能接受。
- 邀请在 7 天后过期,在被接受前可以撤销。
为钱包充值
组织钱包与每位成员的个人余额相互独立。由所有者在组织的账单页面从自己的个人余额转入资金(也可以转回)。使用组织 API Key 的请求按与个人请求相同的模型价格从钱包扣费(见定价);个人折扣和个人 BYOK 凭据不会用于组织请求。 如果钱包余额不足以支付某个请求,该请求会被拒绝,返回402 和 Insufficient organization balance,不会产生任何扣费。
消费额度
所有者和管理员可以在成员页面为每位成员设置四个可选额度:- 留空表示不限额;设为
0表示该成员完全不能消费。 - 额度覆盖该成员所有 API Key 的合计,既计入已完成的请求,也计入仍在进行中的请求。
- 会让成员超出额度的请求在到达模型之前就被拒绝,返回
402和类似Organization daily spend limit would be exceeded的消息,不会产生扣费。 - 成员页面会在额度旁显示每位成员的已用金额,计算方式与额度校验完全一致。
组织 API Key
在账户菜单中切换到该组织,然后照常在 API Key 页面创建。组织 API Key 的格式与个人 API Key 相同(sk-rb-…),同样放在 Authorization: Bearer 请求头中:
- 组织由 API Key 本身决定。不要发送
X-Organization-ID之类的组织请求头,带有这些请求头的请求会被拒绝。 - 消费记在创建该 API Key 的成员名下,并计入该成员的额度。如果希望成员额度相互独立,不要把一个成员的 API Key 给另一个成员使用。
- 只有 API Key 的创建者能再次查看完整的 Key。所有者和管理员能看到所有成员的 API Key(名称、前缀、创建者)并可以撤销,但永远看不到其完整内容。
- 成员退出或被移除时,其组织 API Key 会被撤销。
组织 API Key 目前能调用的接口
组织 API Key 目前仅支持 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 将失效,历史记录会保留。
常见错误
通用的错误格式见错误。