Skip to main content
组织是一个共享的计费账户。成员使用各自的组织 API Key 调用模型,每次请求都从组织钱包扣费,而不是从任何人的个人余额扣费。所有者和管理员可以看到谁花了多少,并为每位成员设置消费上限。 你的个人账户保持不变。个人 API Key、余额、用量和日志仍然是个人的,组织的活动不会出现在其中。

角色

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

创建组织

  1. 打开账户菜单(头像),选择创建组织,或前往设置 → 组织。
  2. 填写组织名称,你将成为该组织的所有者。
  3. 通过头像菜单中的账户切换,在个人和你的各个组织之间切换。控制台页面(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 将失效,历史记录会保留。

常见错误

通用的错误格式见错误。