Sign inGet Started

计费与用量

计费的作用域是组织级别:套餐、钱包和发票流都归属于组织。本页介绍计费如何影响集成:用量如何计量、如何查看当前状态,以及套餐层级如何设定集成运行时的运营限制。有关账户操作(定价详情、支付方式、税务),请参阅知识库:套餐与定价和用量、支出与发票。
计费由人管理,而非集成。每个计费操作都受 org:billing 权限范围限制,这是一个组织角色权限范围,无法授予工作区 API 密钥,因此任何 bk_* 密钥都无法读取用量、充值钱包或更改套餐。所有者和计费管理员在仪表板的 Billing and payments 部分完成这些操作;请参阅用户、团队和角色了解谁拥有该角色。套餐、产品和价格目录是例外:它们无需身份验证,在本站公开定价信息,CLI 和 MCP 可以直接读取套餐目录。因此本指南说明计费对你的集成产生的影响,并指出显示各项数据的仪表板页面。这些页面(Overview、Usage、Invoices、Spend 和 Settings)在全文链接的知识库文章中有详细说明。

套餐与层级

你的组织订阅一个套餐。当前订阅、升级和取消操作在 Billing overview 页面管理。每个套餐对应一个层级(free、startup、growth 或 enterprise),层级决定了你的集成在运行中受到的限制:
  • 包含发送量。 每个套餐包含每月邮件发送配额,按收件人计量:一封发给三个收件人的消息消耗三个额度。付费套餐中,超出配额的发送按超量计费,直到硬性上限;超过上限后,发送将被拒绝并返回限制错误,直至计费周期重置。Free 套餐没有超量机制:达到月度和每日上限即停止。配额、上限和超量上限详见套餐与定价。
  • 请求速率限制上限随套餐提升。 请求速率限制从基础值开始,套餐会将其替换为更高的值,组织级别的覆盖配置可替换前两者,因此更高层级的套餐提升了发送和读取上限。模型、每组的基础速率和请求头详见请求速率限制。
  • 资源限制。 发送域名数量、IP 池数量和专用 IP 数量等上限按套餐设定,可按组织调整。如果达到上限,请联系支持团队,而不是自行绕过。
升级立即生效,在当前周期的剩余时间内提供完整的新配额。降级和取消在当前计费周期结束时生效。付款失败的处理流程及其他时间规则,请参见套餐变更与续订。设计集成时应处理账户超出配额时的错误。

用量计量

每次发送都按组织当前计费周期计量。仪表板的 Usage 页面展示各产品的实时情况,显示窗口取决于产品的计量方式:按套餐周期计量的邮件使用套餐周期,按量付费产品使用日历月。产品按两种方式计费,区别在于你的集成感受到的影响:
  • 按量计量产品在你的套餐中包含用量额度(邮件发送)。页面显示你已消耗了多少额度以及超出了多少,方便你在计费前发现超额趋势。
  • 按量付费产品按费率卡逐次计费(SMS、WhatsApp)。一条消息可能产生两笔钱包扣款:发送处理时 Bird 自身的费用,以及消息送达时的第三方费用(SMS 上的运营商附加费、WhatsApp 上 Meta 的分成)。可从 SMS 或 WhatsApp 消息的 cost 中读取每条消息的费用明细:transaction_amount 是 Bird 的收费,passthrough_amount 是第三方费用。
该页面涵盖当前周期内有订阅或用量的所有产品,并为其中任意产品提供按日、按国家和按发送域的分项图表。
Bird 仪表板中的 Usage 页面:总花费及预测、各渠道发送数和每日用量图表

钱包

每个组织拥有一个钱包:一个共享的预付余额,所有费用都通过它扣除。套餐续费、超额费用和按量付费发送都从钱包中扣款;绑定的银行卡用于充值(手动充值、自动充值,以及余额不足时补足续费费用)。仪表板的 Spend 页面是完整的充值和扣款流水账,所有钱包变动都集中记录在此,每笔到账的充值会生成一份持久收据,可在同一页面下载 PDF。
在运行层面,钱包是按量付费发送的前提:当余额不足以支付时,SMS 和 WhatsApp 发送会被拒绝。SMS 在 API 处被拒绝并返回 402;WhatsApp 发送会先被接受,在 Bird 尝试扣费时再被拒绝。送达时产生的费用如果余额不足则跳过而非拒绝,消息仍会送达收件人。对于事务性发送量,请在 Billing overview 上配置自动充值和低余额提醒,或在你自己的系统中监控和报警。付款方式和钱包涵盖了这两项仪表板控制。低余额警告和支付失败通知发送给组织所有者。账单邮件在设置了计费通知列表时发送至该列表,否则回退到组织所有者。在 Settings > Organization 下设置该列表。建议使用受监控的团队邮箱别名,避免计费邮件依赖于个人收件箱。

发票

发票按组织发出,每个日历月一张,列在仪表板的 Invoices 页面,你可以打开查看明细或下载 PDF。发票反映的计量数据与 Usage 页面一致:套餐的周期性费用加上该周期内的超额计量和按量付费花费。关于发票的结构、状态和付款时间,请参阅知识库中的用量、花费和发票。

后续步骤

相关资源

继续查阅此主题的文档、指南和示例。资源为英文。

获取实施简报