计费与用量
计费的作用域是组织级别：产品套餐、钱包和发票流都归属于组织。本页介绍计费如何影响集成：用量如何计量、如何查看当前状态，以及套餐如何影响运营限制。有关账户操作（定价详情、支付方式、税务），请参阅知识库：套餐与定价和用量、支出与发票。
计费由人管理，而非集成。每个计费操作都受 org:billing 权限范围限制，这是一个组织角色权限范围，无法授予工作区 API 密钥，因此任何 bk_* 密钥都无法读取用量、充值钱包或更改套餐。所有者和计费管理员在仪表板的 Billing and payments 部分完成这些操作；请参阅用户、团队和角色了解谁拥有该角色。套餐、产品和价格目录是例外：它们无需身份验证，在本站公开定价信息，CLI 和 MCP 可以直接读取套餐目录。因此本指南说明计费对你的集成产生的影响，并指出显示各项数据的仪表板页面。这些页面（Overview、Usage、Invoices、Spend 和 Settings）在全文链接的知识库文章中有详细说明。
套餐与层级
每个产品都有各自独立选择的套餐：一个组织可以同时拥有付费的 SMS 套餐、Realtime 套餐和 Email Free 套餐，并让 Voice 保持按量付费。每个套餐对应一个层级（如 free、startup、growth 或 scale），以及两种财务行为之一。充值型套餐每月向共享钱包存入一笔款项，并从第一次发送起扣除用量费用；容量型套餐购买包含的用量，不向钱包存入任何款项。套餐与定价对两者都有说明，Billing overview 列出了你的组织当前的套餐。
套餐决定了你的集成在运行中受到的限制：
- 请求速率限制随层级提高。 每个套餐为其产品的策略（如
sms_send或whatsapp_send）设定值，层级越高，值越高。没有套餐时使用策略默认值。组织级别的有效覆盖配置优先于所有套餐。参见限制如何确定。 - 配额随层级提高。 套餐设定各类数量，如 Voice 并发通话数、Realtime 连接数、发送域名、专用 IP 和 webhook 端点。达到配额后，新的资源、通话或连接会被拒绝并返回专门的错误；这与
429请求速率限制响应不同。 - 包含额度在达到套餐限制时用尽。 Email Free 套餐在达到月度和每日上限时停止，Realtime 套餐在达到连接数和每日消息限制时停止。付费 Email 套餐没有包含额度：每次发送都从钱包扣费。
要在无需身份验证的情况下读取任意套餐的公开值，请使用 bird billing plans list --commercial-product sms 列出套餐目录。每个套餐返回其 financial_behavior、rate_limits 和 quotas。每个产品的定价页面上的对比表会将这些值与按量付费的默认值并列显示，因此为扩容而升级前，请先在该页面比较两者。
升级在付款成功后生效，因此新限制会在周期中途生效，续订日期不变。降级和取消在当前周期结束时生效；续订未付款时，该产品会恢复为其免费套餐或按量付费的限制。时间规则请参见套餐变更与续订。设计集成时，应处理套餐变更或额度用尽时出现的限制错误。
用量计量
每次发送都按组织当前计费周期计量。仪表板的 Usage 页面展示各产品的实时情况，显示窗口取决于产品的计量方式：按套餐周期计量的邮件使用套餐周期，按量付费产品使用日历月。产品按两种方式计费，区别在于你的集成感受到的影响：
- 按量计量产品根据套餐的包含额度计算用量（Email Free 套餐或旧版 Email 套餐上的邮件发送）。页面显示你已消耗了多少额度；对于有超额计费的旧版套餐，还会显示超出了多少。
- 按量付费产品按费率卡逐次计费（SMS、WhatsApp、Voice，以及付费 Email 套餐上的邮件），套餐有费率时按套餐费率计算。一条消息可能产生两笔钱包扣款：发送处理时 Bird 自身的费用，以及消息送达时的第三方费用（SMS 上的运营商附加费、WhatsApp 上 Meta 的分成）。可从 SMS 或 WhatsApp 消息的
cost中读取每条消息的费用明细：transaction_amount是 Bird 的收费，passthrough_amount是第三方费用。
该页面涵盖当前周期内有订阅或用量的所有产品，并为其中任意产品提供按日、按国家和按发送域的分项图表。
钱包
每个组织拥有一个钱包：一个共享的预付余额，用量费用通过它扣除。按量付费发送、附加订阅和旧版 Email 套餐续费都从钱包扣款。充值型套餐为钱包充值：每笔已支付的月度存款全额计入，可用于支付任何产品。绑定的银行卡也可通过手动充值和自动充值为钱包充值，并直接支付套餐续费。仪表板的 Spend 页面是完整的充值和扣款流水账，所有钱包变动都集中记录在此，每笔到账的充值会生成一份持久收据，可在同一部分下载 PDF。
在运行层面，钱包是按量付费发送的前提：当余额不足以支付时，SMS 和 WhatsApp 发送会被拒绝。SMS 在 API 处被拒绝并返回 402；WhatsApp 发送会先被接受，在 Bird 尝试扣费时再被拒绝。送达时产生的费用如果余额不足则跳过而非拒绝，消息仍会送达收件人。对于事务性发送量，请在 Billing overview 上配置自动充值和低余额提醒，或在你自己的系统中监控和报警。付款方式和钱包涵盖了这两项仪表板控制。低余额警告和支付失败通知发送给组织所有者。账单邮件在设置了计费通知列表时发送至该列表，否则回退到组织所有者。在 Settings > Organization 下设置该列表。建议使用受监控的团队邮箱别名，避免计费邮件依赖于个人收件箱。
发票
发票按组织开具，每个日历月一张，列在仪表板的 Invoices 页面，你可以打开查看明细或下载 PDF。发票反映的计量数据与 Usage 页面一致：该周期内的容量套餐费用、旧版套餐费用和超额费用，以及按量付费花费。注资套餐的存款是一笔钱包充值，附有单独的收据；它所支付的用量显示在发票上。关于发票的结构、状态和付款时间，请参阅知识库中的用量、支出与发票。