阶跃星辰企业组织与额度管理怎么配：项目、成员与 Credit

2026-08-25

数据截至 2026-08，价格与限额以各官网为准。本文只讲计费与接入机制，不列具体价格数字。

阶跃星辰的企业组织，本质是把「一份额度」和「一堆人」用项目这一层隔开：组织持有一个 Credit 账户，全体成员共用；主账号按业务线建项目，把成员放进项目，成员才能在项目下建 API Key；额度约束有两级，项目月度上限和成员在项目内的月度上限，都是默认不设置。真正决定一次调用能不能过的，是「组织 Credit 账户余额、项目当期剩余上限、成员当期剩余上限」三者里最紧的那一项——任意一项不够就直接拒绝，而且不产生扣费。额度打满和被限流都返回 429，必须靠错误标识区分。

下面按真实的搭建顺序走一遍：先弄清空间的划分，再是开通、建组织结构、设上限、读返回、查明细。其中的机制与规则均出自阶跃星辰官方文档的组织与项目章节，配置顺序上的取舍是本文自己的建议。

先分清个人空间和组织空间

这一层没分清，后面设上限、查用量都会绕弯路。官方的口径是：一个账号对应一位使用者，账号可以在个人空间与组织空间之间切换，两个空间的 API Key、额度与用量相互独立。

区别就一句话：个人空间用的是账号自己的 API Key，费用由账号自身承担；组织空间用的是各项目下的 API Key，费用由组织的 Credit 账户承担。

切换入口在控制台右上角的「用户中心 > 空间切换」。注意这个入口不是一直都在——官方明确说明，账号完成企业认证，或者被邀请加入某个组织之后，该入口才会出现。所以如果你刚拿到账号就到处找空间切换而找不到，多半不是页面藏得深，而是前置条件还没满足。

一个账号可以同时属于多个空间。官方举的例子是：在本企业的组织中是主账号，同时又是合作方组织的成员。而组织之间是彻底隔离的——Credit、成员、项目与额度上限均不互通，一个账号加入多个组织时，在每个组织里花的都是该组织自己的额度。

组织由哪几层构成

官方文档把组织拆成五个概念，每一层的职责很清楚：

组织：团队的容器，持有一个 Credit 账户，账户里的额度由全体成员共用。
主账号：完成企业认证并开通企业套餐的那个账号，负责管理组织的成员、项目与额度。
成员：由主账号邀请加入组织的账号，在自己参与的项目下调用模型。
项目：组织内的分组单位，用于隔离 API Key 并分配 Credit 额度。
API Key：调用凭证，归属于「某位成员在某个项目下」，每位成员在每个项目中最多创建一个。

这里有两条约束值得单独拎出来。一是「每位成员在每个项目中最多创建一个 API Key」——想给同一个人在同一个项目里分出「测试用」和「生产用」两把钥匙是做不到的，要拆就得拆成两个项目。二是「成员需先被添加到项目，才能在该项目下创建 API Key」——只邀请进组织还不够，人还在组织外围转，得再进项目。

另外，组织下的默认项目不支持删除，主账号可以按业务线、团队或运行环境另行创建项目。

开通企业套餐的路径

官方文档写的是签合同这条路，没有自助开通：

在控制台完成企业认证。认证通过后，账号获得一个组织，右上角出现空间切换入口。已认证的账号跳过这步。
切换到组织空间，在「企业套餐 > 订阅情况」里点「联系销售」，填表单提交，会有人联系沟通用量规模与商务方案。
双方确认方案后签订合同，Credit 按合同约定发放至组织的 Credit 账户。

如果认证已经通过、但空间切换入口没出现，官方给的处理方式只有一条：提交工单联系他们。所以别在这一步反复重做认证，走工单更省事。

开通之后有两个查账入口：「企业套餐 > 订阅情况」看当前订阅状态；「企业套餐 > 支付记录」按订单展示历次 Credit 发放，字段包括订单编号、购买时间、消费金额、到账的 Credit 数量与支付状态。需要发票时，在支付记录对应订单处发起申请，或者去「支付管理 > 发票管理」，发票可以按购买金额开，也可以按消耗金额开——这两种口径对财务的意义完全不同，报销前先和财务对齐。

Credit 是怎么算出来的

组织的额度以 Credit 计量。成员调用模型时，平台先按模型定价算出费用，再折算为 Credit 从组织账户扣减。这里有两个数字要分别去两个地方查，别找错页：折算比率是官方给定的一个固定系数，写在官方「Credit 额度规则」页的「计量口径」一节；各模型的单价在官方的「定价详情」页。官方给的换算口径是：单价乘以这个系数，即为对应的 Credit 消耗量。本文不复述这两组具体数字——单价随时可能调整，抄进来就是给自己埋雷。

到账的 Credit 数量由合同约定的商务条件确定，不是按公开定价直接换算的。

有效期这件事必须提醒：Credit 的有效期从合同到期日往后再延一段固定期限（具体天数以官方文档当前版本为准），到期未使用的 Credit 自动失效且不可恢复。账户里存在多笔 Credit 时，平台按到期时间由近及远依次扣除。这个扣减顺序对续约的团队是好事——先烧快过期的那批，不会出现新充的先花完、旧的白白作废。

邀请成员、建项目、分配额度

这些页面只有主账号可见，都在组织空间的「组织管理」下。官方还提到，以下操作均可通过命令行工具完成，不是只能点页面。

邀请成员：进「组织管理 > 成员管理」点「邀请成员」，在文本框里输被邀请人手机号，一行一个，可以一次提交多个。平台向这些手机号下发含邀请链接的短信。已注册的手机号确认后即成为成员，未注册的手机号完成注册后自动加入本组织。邀请链接自发起时刻起有一个有效期（天数以官方文档为准），未被接受的邀请留在待接受列表，超期后移入已过期邀请列表，需要重新发起。

移除成员：在成员行点「移除成员」。官方在这里挂了警告——移除后，该成员名下的全部 API Key 失效，不可再用于调用。还有一条容易踩：成员不能自行退出组织，想走只能让主账号移除。

创建与删除项目：进「组织管理 > 项目管理」点「创建项目」，填项目名称（长度有上限，以官方文档为准），描述选填。删除项目同样带警告——项目下的所有 API Key 一并删除且不可恢复；默认项目不提供删除操作。

项目成员进出：在项目列表点「查看详情」进项目详情页，在「项目成员列表」点「添加项目成员」，下拉里搜索并选择组织成员，可一次添加多人。把人移出项目时，该成员在本项目下的 API Key 失效，但组织成员身份保留——这是一个比「移除出组织」更轻的动作，做权限收缩时优先用它。

主账号自己的 Key：主账号在任意项目下都能创建属于自己的 API Key，不必先加入该项目。这类 Key 在列表中带「我的」标签，可以改名和删除，删除后立即失效且无法撤回，需要的话在该项目下重新创建。Key 的保管纪律和个人账号是一样的，可以参考API Key 安全管理。官方把保管警告挂在成员创建自己 Key 的那一节，原话是「任何获得该 Key 的人都能以您的身份调用模型，并消耗组织的 Credit」——这句针对的是任意一把项目 Key，主账号自己建的那把也不例外，而且主账号可以在任意项目下建 Key，一不留神就散落在好几个项目里，更需要自己记账。

两级月度上限的生效规则

Credit 账户由全体成员共用，在这个前提上，主账号可以为项目、以及项目中的个别成员设置月度 Credit 上限。有一点先说清楚：上限只约束 Credit 用量，不影响速率限制，想控并发得另走限流那条线。

项目月度上限：默认不设置。设置后，项目当期用量达到上限时，该项目下的所有 API Key 停止调用。入口在项目详情页的「项目额度管理」卡片，点「设置上限」或「编辑上限」，填月度 Credit 上限确认；把上限留空并确认，就是取消该项目的上限。设置后卡片会显示上限值、当期用量与下次重置时间。
成员在项目内的月度上限：按项目分别设置，只约束该成员在本项目内的用量。入口在项目详情页的「API Key 列表」，找到该成员那一行点「设置上限」，在「成员额度管理」弹窗里填。留空表示不单独限制，该成员仅受项目上限约束。触顶后只有这个成员停，项目内其他成员不受影响。

统计周期是自然月，每月 1 号 00:00 重置。两条边界规则要记住：月中启用上限时，当月按完整上限计算，不按剩余天数折算；月中修改上限值时，已用量不清零、周期也不重置，新的上限值直接减去已用量。也就是说月中把上限调低，可能一改完就立刻触顶。

还有一个反直觉但很实用的设计：项目上限之和可以超过 Credit 账户余额，成员上限之和也可以超过所在项目的上限。平台不强制让这些数字对得上，实际可用额度取其中最紧的一项。这意味着上限更像「防跑飞的闸」，不是「预算切分」，别指望把它当分账工具用。

单次调用到底能扣多少

官方给了一条明确的公式：一次调用实际可扣减的 Credit，不超过以下三者中的最小值——

min(Credit 账户余额, 项目当期剩余上限, 成员当期剩余上限)

本次调用的用量超过该值时，调用被拒绝，且不产生扣费。

请务必按「最小值」理解，而不是「三个都不够才拒」：任意一项不足都会挡住这次调用。排查线上突然全线报错时，这三项要一项一项看，不能只看账户余额还很充裕就排除额度问题。

额度打满时返回什么

官方把三种额度不足的返回列成了对照表，错误标识是排查的关键：

情况	状态码	错误标识	恢复方式
Credit 账户余额不足	402	`insufficient_credit`	联系销售补充 Credit
项目达到月度上限	429	`project_credit_limit_exceeded`	主账号调高项目上限，或等下月 1 号重置
成员在项目内达到月度上限	429	`member_project_credit_limit_exceeded`	主账号调高该成员上限，或等下月 1 号重置

额度上限与速率限制返回的状态码同为 429，官方专门提示收到 429 时要以错误标识区分两种情况。这条如果不知道，运维侧很容易把「预算闸打满」误判成「被限流」，然后一路去加退避重试——重试多少次都过不去。通用的 429 处理思路见API 429 的通用处理方式，阶跃自己的错误标识对照见阶跃错误码与异常处理对照。

成员侧还有第四种现象：API Key 不可用。官方给的原因是 Key 已被禁用或删除，或者你已被移出该项目、该组织；处理方式是在「账户管理 > 接口密钥」确认状态，必要时联系主账号。主账号禁用 Key 的入口在项目详情页「API Key 列表」对应行的「禁用」，禁用后该 Key 立即无法调用，成员侧显示为「已被管理员禁用」，成员不能自行恢复，点「启用」才恢复。

成员这边怎么用

接受邀请后，通过右上角「用户中心 > 空间切换」进组织空间，然后在「账户管理 > 接口密钥」建 Key。这个页面按项目列出你参与的每个项目，在目标项目行点「创建密钥」，填名称确认，然后把完整的 Key 复制保存好。

调用方式没有任何特殊之处：项目下 API Key 的用法与个人 API Key 一致，不需要额外传递组织或项目标识。平台按 API Key 的归属结算费用，并把每次调用计入对应的项目与成员。官方给的调用示例仍然是标准的 chat completions 形态：

curl https://api.stepfun.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $STEPFUN_API_KEY" \
  -d '{
    "model": "step-3.7-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

这个设计的好处是迁移成本几乎为零：个人试用阶段写的代码，换一把项目 Key 就能跑在企业额度上，不用改请求体。代价是从请求本身看不出这次调用记到了哪个项目——归属完全由 Key 决定，所以 Key 发下去之前就得把项目划分想清楚。

用量明细在哪看

主账号视角：「组织管理 > 组织用量」的「Credit 账户」卡片展示本合同周期内的 Credit 已用量、总额度与有效期，这里的合同周期指合同的生效日至到期日。下面的「使用详情」按调用记录展示明细，可以按时间范围（默认本月）、项目、成员 ID 与模型／能力筛选，并导出当前筛选结果；汇总卡片「组织 Credit 总扣减」会随筛选条件变化。

成员视角：「账户管理 > 使用详情」展示自己的调用明细，可按密钥名称、模型与日期区间筛选并导出。「账户管理 > 接口密钥」里的「Credit 已用 / 上限」一列展示你在该项目下的当期用量，上限显示为「不限」时表示主账号没有对你单独设上限，此时仍然受项目整体上限与组织 Credit 余额约束。

读明细时有个细节别看错：每一行对应一个计费项，同一次调用产生多个计费项时（官方举的例子是输入 Token 与输出 Token），会拆成多行展示。所以行数不等于调用次数，按行数估调用量会偏高。要做长期的成本归因，把导出的明细接到自己的看板里更稳，思路可以参考API 成本监控怎么做。

不可逆的动作清单

把不可逆的动作单独列一下，这些在官方文档里都是带警告框或明确写了「不可恢复」的：

移除组织成员后，该成员名下的全部 API Key 失效——不只是某一个项目下的那把。
删除项目后，项目下所有 API Key 一并删除且不可恢复；默认项目干脆不给删。
删除自己的 API Key 后立即失效且无法撤回，只能在该项目下重新创建一把新的。
Credit 到期未使用自动失效且不可恢复，多笔 Credit 按到期时间由近及远扣。
成员不能自行退出组织，也不能自行恢复被管理员禁用的 Key，这两件事只有主账号能做。

真正开始配之前，建议先把项目的划分维度定下来。因为「每位成员在每个项目下只能有一把 Key」这条约束，项目维度直接决定了你能把用量拆到多细——按业务线拆，就只能看到业务线级别的成本；按环境拆，才分得出测试烧了多少。这个决定改起来代价不小（重建项目意味着旧 Key 全废），值得多花半小时想清楚。