企业账号

企业账号让整个团队从同一个余额里消费。企业主的账号余额就是企业余额，每位成员用自己的 Key 调用 API，所有费用都从这份共用余额里扣。接口、请求体和客户端配置与个人账号完全相同，本页只说明调用方属于企业时有哪些不同。

成员发起请求

acme-…

使用自己的 Key，以企业前缀开头。

检查额度

这次请求的预估费用必须放得进成员剩余的额度。

记到企业账上

按企业主账号的价格、分组和订阅计费。

记在成员名下

企业主和管理员可以按成员、模型、Key 和日期查看。

成员手里没有自己的钱，额度只限制他能从企业余额里花多少。

角色

角色	账号	能做什么
企业主	提交申请的账号	余额就是企业余额。管理所有人、充值、查看全企业用量。不能被停用。
管理员	通过邀请创建	在额度内调用 API，邀请和管理成员、充值、查看全企业用量。
成员	通过邀请创建	在额度内调用 API、图像与视频工作台和 Castaly。不能充值。

管理员和成员都是通过邮件邀请新建的账号，受邀邮箱不能已在平台注册，所以已有的个人账号不能加入企业。这些账号不参与平台的奖励活动。

企业主和管理员可以随时停用账号，该账号的登录会话和 Key 立即失效。账号只能停用、不能删除，用量历史会一直保留。

API Key

企业 Key 以企业的 Key 前缀开头，例如 acme- 后面跟 48 位字母和数字。前缀在申请时填写，审核通过时确定，之后不能修改。前缀为 2 到 16 位小写字母和数字，以字母开头。

同一把 Key 把前缀换成 sk- 也能用。如果某个客户端只接受 sk- 开头的 Key，就用这种写法：两种写法是同一把 Key，权限和计费完全相同。

Text

Authorization: Bearer acme-<48 characters>
Authorization: Bearer sk-<48 characters>

Key 带的前缀不属于它所在的企业时，按无效 Key 处理，返回 401。

企业主在申请通过前创建的 Key 也会显示为企业前缀，原来的 sk- 写法继续有效，已有的接入不需要改动。

管理员和成员在控制台只能创建和看到自己的 Key。企业主和管理员可以在企业控制台按成员管理全企业的 Key。

成员额度

每位管理员和成员都有一个额度。钱不会划给他们，额度只是他们最多能从企业余额里花多少。

模式	规则
不限	只受企业余额约束。
一次性	一笔固定额度，不会自动重置。
按月	每月 1 日 00:00（UTC）从零重新计算。

只调整上限时，已用金额保留；切换到其他模式时从零开始计算。

请求开始前，网关按预估费用从成员剩余额度里预留，放不下就直接拒绝。请求结束后按实际费用结算。结算不会拒绝，所以最后一笔请求可能让成员略超上限，下一笔才会被拒绝。请求失败或退款时，金额也会退回成员额度。

成员用到额度的 80% 和用完时，都会收到邮件提醒。

计费、分组与限速

在网关看来，成员的请求就是企业主账号的请求。除额度外，其他一切都按企业主账号生效：

• 费用从企业余额扣除，扣法与企业主自己调用时相同，企业主的订阅同样可用。
• 价格、分组以及 Key 能调用的模型，都以企业主账号为准。
• 限速按整个企业计算。企业主和所有成员共用一份限额，所以 429 可能是团队里其他人的请求触发的。

企业余额用完后，企业内所有人的请求都会返回 403 和 insufficient_user_quota，与个人账号余额不足时相同。企业主和管理员可以在企业控制台充值，成员不能充值。设置余额提醒线后，余额跌破时企业主和管理员会收到邮件。

报错

情况	状态	如何识别
Key 带的是其他企业的前缀	401	按无效 Key 处理
成员额度已用完	403	code 为 enterprise_member_budget_exhausted
成员被停用，或企业被平台暂停	403	message 说明账号已停用
企业余额已用完	403	code 为 insufficient_user_quota
整个企业触发限速	429	与个人账号相同

401 和 403 这几种情况重试不会恢复。额度报错要等管理员调高上限，按月额度也可以等到下个月；余额报错在充值后恢复。

异步任务

用成员 Key 提交的任务，只能用该成员自己的 Key 查询。用其他成员的 Key 查询，结果与任务不存在相同。企业主的 Key 可以查询企业内任何人提交的任务。

用量与日志

• 每条请求日志都记录是哪位成员发起的。
• 管理员和成员在自己的控制台里只能看到自己的请求。
• 企业主的日志页能看到全企业的请求，并多一列“成员”。
• 企业主和管理员可以在企业控制台按成员、模型、Key 和日期统计消费，并打开任意成员的逐条请求。
• 能查多久取决于企业主账号的日志保留期，见数据保留与清理。企业主缩短保留期，企业报表也随之缩短。

开通企业账号

在 Modelflare 控制台提交申请，填写企业名称、想要的 Key 前缀和联系邮箱。审核通过后，你的账号成为企业主，账号余额成为企业余额，然后在企业控制台邀请团队成员。完整方案见企业方案。