套餐与账单
每个应用使用一个套餐，套餐决定应用的各项额度（如注册用户数、并发连接数、群数、存储容量）和价格（月费和按量计费）。每个租户每月一张账单，列出名下各应用上个月的费用，通过银行转账付款。本页介绍计费的规则、套餐包含的额度、在控制台查看用量和账单，以及付款和逾期后的处理。
计费相关的内容在控制台的两个地方：
- 菜单“费用中心”：“账户”“账单”“流水”“用量汇总”“套餐”五个标签页。
developer只能看到“套餐”； - 应用详情的“套餐与用量”标签页：这个应用当前的套餐、额度、套餐变更历史和每日用量，所有成员都能查看。
计费规则
- 按应用订阅，按租户出账：每个应用在任何一天都只使用一个套餐，额度按应用分别执行；账单按租户出具，一张账单列出名下全部应用的费用。测试应用和生产应用可以使用不同的套餐，测试应用通常使用免费的套餐。
- 账期与时区：账期为北京时间（UTC+8）的自然月。套餐的生效日、每日用量和账单中的日期都按北京时间划分。
- 按天计费：一天只按一个套餐计费。月中开始使用、更换或停止使用套餐的，月费按天折算。
- 后付费：每月初为上个月出账，出账后在付款期限内付款。也可以预先转账作为余额，出账时自动从余额扣除。
- 新应用：自动使用平台的默认套餐，从创建当天开始计费。
- 更换套餐：由我们为应用更换，见更换套餐。控制台中不能自行更换。
- 照常计费的情况：应用被停用、租户被暂停（包括因欠费暂停）、租户处于注销冷静期时，数据和资源仍然保留，照常计费。需要停止计费的应用，请联系我们改为免费套餐，或者删除应用。
- 停止计费：应用删除当天、租户注销生效当天是最后一个计费日。
- 金额：以人民币计价，控制台中显示为元，精确到分。账单金额即应付金额，不另列税额；需要发票时请联系我们。
更换套餐
在“费用中心”的“套餐”中查看可以选择的套餐，确定后请联系我们为应用更换。更换可以立即生效，也可以预定在以后的某一天生效（最晚一年后）：
- 立即生效：额度随即按新套餐执行，通常几秒内生效；费用从生效日起按新套餐计算。生效日也可以是本月内已经过去的某一天（不早于应用开始计费的那天），这个月从那天起按新套餐计费；
- 预定生效：在生效日 0 点（北京时间）生效。生效之前，应用的“套餐与用量”中显示“预定的变更”，需要修改或取消请联系我们；
- 上个月及更早的套餐不能再修改。需要更正时，我们会在之后的账单中以调整项补收或减免。
额度变化后，客户端的运行配置随之更新：群人数上限、消息保留天数和音视频开关取新的值，在线的客户端会收到新的运行配置。
我们还可以为某个应用单独调整部分额度，例如活动期间临时提高并发连接数。单独调整只改变额度，不改变价格，更换套餐时保留。控制台中显示的额度已经包含单独调整的值。
为你更换套餐、调整额度、记录收款等操作都会写入操作日志，操作人为平台。
消息保留天数缩短时会删除消息
除消息保留天数外，额度调低后已有的数据都不受影响，只是不能再增加。新套餐的消息保留天数比原来短时，超出保留期的消息随即不能再拉取，并被陆续删除，改回原来的套餐也不能恢复。
套餐的内容
一个套餐包括三部分：
- 额度：应用能使用的资源上限，用满后相应的操作被拒绝；
- 月费：固定费用，不满一个月的按天折算；
- 按量计费：部分计量项可以设置套餐包含的用量和超出部分的单价，超出包含量的部分另行计费。套餐没有列出的计量项不计费。
额度
在应用的“套餐与用量”中查看当前的额度。额度为 0 时显示为“不限”。
| 额度 | 说明 | 用满时 |
|---|---|---|
| 注册用户数 | 应用中未删除的用户数，含已封禁的 | 不能再创建用户：服务端和控制台创建用户、客户端注册、签发登录凭证时自动创建用户都返回 409 limit_exceeded，没有 details；批量创建时超出的用户出现在失败的项中 |
| 并发连接数 | 应用同时在线的长连接数 | 新的长连接被关闭，错误码 limit_exceeded，details.reason 为 app_connection_limit，并提示 30 到 60 秒后重试；已经建立的连接不受影响 |
| 群总数 | 应用中未解散的群数 | 建群返回 409 limit_exceeded，details.reason 为 app_group_limit |
| 每个群的人数 | 每个群的人数上限，含群主 | 不能再加人，details.reason 为 group_member_limit |
| 每人可加入的群数 | 每个用户加入的群数上限，含自己是群主的 | 这个用户不能再建群或入群，details.reason 为 user_group_limit |
| 消息保留天数 | 消息的保存时间 | 超出保留期的消息不能再拉取，并被陆续删除 |
| 存储容量 | 应用的文件（附件、头像、群文件等）占用的空间，1 GB 按 230 字节计 | 不能再上传：创建上传返回 409 limit_exceeded，details.reason 为 storage_quota；已有的文件照常下载 |
| 并发通话数 | 应用中活跃通话与活跃频道媒体代次合计（含尚未清理的占用） | 不能再发起通话，返回 409 limit_exceeded，details.reason 为 app_concurrent_calls，details.limit 为额度 |
| 聊天室数 | 应用中未解散的聊天室数 | 不能再创建聊天室，返回 409 limit_exceeded，details.reason 为 chatroom_limit |
| 音视频 | 应用能否使用音视频通话 | 不能使用时，发起、接听或加入通话以及在群通话中邀请他人都返回 403 permission_denied，details.reason 为 rtc_disabled；进行中的通话不受影响 |
部分额度与运行策略或平台的配额共同起作用：
- 每个群的人数、每人可加入的群数、消息保留天数、音视频：运行策略中也有对应的设置，可以设得比套餐更严格，实际按两者中较严格的执行。运行策略设得比套餐宽时，按套餐执行，“应用策略”页面中显示的仍是策略本身的值。每个群的人数还可以为单个群设置更小的上限；
- 存储容量、聊天室数：平台另有一项保护性的配额，实际按两者中较小的执行，见限流与应用状态。
客户端的运行配置中的群人数上限、消息保留天数和音视频开关就是实际执行的值。服务端查询存储用量时返回的额度，也已经按套餐计算。
额度调低后，已经超出新额度的数据不受影响，只是不能再增加：用户数已经超过的不能再创建用户，群人数已经超过的不能再加人，已经建立的连接不会断开，存储已经超过的不能再上传。消息保留天数是例外，见上文的提示。
计量项
用量每天统计。以下是统计的计量项，套餐可以对其中的项目按量计费：
| 计量项 | 含义 |
|---|---|
| 消息数 | 发送的单聊和群聊消息条数，客户端、服务端和控制台发送的都计入。服务端批量发送时每个接收人计一条；群消息每条计一次，不按成员数计算；群提示等系统消息不计入 |
| 日活 | 当天至少成功建立过一次长连接的用户数，连接跨过 0 点的两天都计入；只调用 HTTP 接口、没有建立长连接的用户不计入 |
| 月活 | 当月至少成功建立过一次长连接的用户数，口径同日活 |
| 并发连接数峰值 | 每分钟统计一次应用的在线连接数，当天的最大值 |
| 存储量 | 应用的文件占用的空间，每天统计一次，按 GB 向上取整 |
| 语音通话、视频通话 | 每个参与者接通后在通话中的时长，每次通话每人向上取整到分钟，接通前的呼叫时间不计；按通话结束的日期计入 |
| 聊天室消息数 | 被接受并推送的聊天室消息条数；成员进出等通知不计入 |
| 聊天室连接数峰值 | 每分钟统计一次应用全部聊天室中的连接数之和，当天的最大值 |
| 文本审核、图片审核、语音审核、视频审核 | 使用平台提供的审核服务的审核次数。命中审核结果缓存的不计入；使用你自己的审核账号的不计入，由你与审核服务商结算 |
| 注册用户数 | 应用中未删除的用户数，每天统计一次，只用于展示，不计费 |
每天 01:00（北京时间）统计前一天的用量。个别项目当时还没有统计完成的，之后自动补上；最近两天的数值可能还会小幅修正。月活每天更新为本月至今的值，下个月 1 日定稿。
按量计费的计算方法
账单中，每个应用使用每个套餐的一段日期（以下称“区间”，截取到当月内）分别计算，每一行四舍五入到分。表中的“单价”是每个计价单位的价格，如“每 1 万条 1 元”即每条 0.0001 元：
| 项目 | 计算方法 |
|---|---|
| 月费 | 月费 × 区间天数 ÷ 当月天数 |
| 消息数、通话分钟数、聊天室消息数、审核次数 | 区间内每天的用量之和，减去“包含量 × 区间天数 ÷ 当月天数”（向下取整），超出的部分按单价计费 |
| 日活 | 区间内每天超出包含量的人数之和（人·天）按单价计费。日活的包含量是每天的人数 |
| 并发连接数峰值、聊天室连接数峰值、存储量 | 区间内每天的值中最大的一个，超出包含量的部分按单价计费，再 × 区间天数 ÷ 当月天数 |
| 月活 | 当月的月活超出包含量的部分按单价计费。只按当月最后一个计费日所用的套餐计算一次，不按天折算 |
例如某个套餐月费 299 元，每月包含 500 万条消息，超出部分每 1 万条 1 元。应用 10 月 5 日开始使用这个套餐，10 月（31 天）共 27 天，期间发送了 600 万条消息：
- 月费：299 × 27 ÷ 31 = 260.42 元；
- 包含的消息数：500 万 × 27 ÷ 31 = 4354838 条，超出 1645162 条，费用为 1645162 × 0.0001 = 164.52 元。
计算结果为 0 的项目不列入账单。全部应用都在免费套餐、用量也都没有超出包含量的租户，没有费用，不会收到账单。
在控制台查看
可选的套餐
“费用中心”的“套餐”列出你可以选择的套餐：目前提供的公开套餐，以及你的应用正在使用的定制套餐（标有“定制”）。每个套餐显示月费、简介、各项额度、音视频能否使用和按量计费的价格，例如“消息数：包含 500 万条，超出每 1 万条 ¥1.00”。日活的包含量是每天的人数，其他计量项的包含量是每月的量。
应用的套餐与用量
在应用详情的“套餐与用量”中查看：
| 项目 | 说明 |
|---|---|
| 套餐、月费、生效日 | 当前的套餐名称和编码、月费，以及从哪天开始使用这个套餐 |
| 按量计费 | 当前套餐的按量价格，没有时显示“不按量计费” |
| 额度 | 各项额度和音视频能否使用，见额度 |
| 第一个计费日 | 应用开始计费的日期，一般是创建应用的那天 |
| 预定的变更 | 今天之后将要生效的套餐变更，没有时不显示 |
| 套餐变更历史 | 最近 12 个月内使用过的套餐和起止日期（含预定的变更），“至今”表示没有结束日期 |
| 每日用量 | 每天的消息数、日活、并发连接数峰值、语音和视频通话分钟数、聊天室消息数、文本和图片审核次数、注册用户数、存储量（GB），以及涉及的各月的月活 |
每日用量默认显示本月 1 日到昨天（每月 1 日显示上个月整月），可以选择其他日期范围：一次最多 93 天，可以查看本月和之前 13 个月的用量。用量截至前一天，显示为“-”的是还没有统计到；月活后标有“未定稿”的，是这个月还没结束或还没有定稿。
账户与本月费用预估
“费用中心”的“账户”显示：
| 项目 | 说明 |
|---|---|
| 余额 | 预存或多付的金额，出账时自动用来结清账单 |
| 未结清 | 已出账、还没有付清的金额合计 |
| 已逾期 | 其中已过付款截止时间的金额 |
| 服务状态 | 正常、只读或暂停，见逾期与欠费 |
| 付款期限 | 出账后多少天内付款，默认 15 天，以合同约定为准 |
| 最早逾期账单的截止时间 | 有逾期账单时显示 |
| 账单联系人 | 接收账单和付款提醒的邮箱，见账单联系人与通知 |
| 本月费用预估 | 按截至昨天的用量和当前的套餐估算本月的费用，并列出各应用的金额 |
本月费用预估中的月费按整个月计算（包括本月内预定的套餐变更），按量部分只计算已经统计到的用量，不含调整项；结果最多缓存 10 分钟。实际金额以账单为准。
账单
每月 1 日起为上个月生成账单，我们核对后出账，一般在 3 天内。出账后账单出现在“费用中心”的“账单”中，同时通知账单联系人。账单编号为 {org_name}-{年月}，如 6195295143-202609，付款时请在转账备注中填写。
账单的状态：
| 状态 | 说明 |
|---|---|
| 已出账 | 等待付款，过了付款截止时间仍未付清的另标有“逾期” |
| 已结清 | 已经付清，包括出账时用余额结清的和应付金额为 0 的 |
| 已作废 | 账单有误被作废，详情中显示作废原因；已经付的金额退回余额。同一账期重新出具的账单，编号后加 -2、-3 |
经我们确认、缺少的个别用量按 0 计算的账单，另标有“数据不完整”。
账单列表可以按状态筛选，也可以只看逾期的账单。点击一行查看账单详情：
- 金额：费用（月费和按量费用合计）、调整、应付、已付、未付，以及账期、付款截止时间和出账时间；
- 按应用的小计：每个应用的金额；不针对某个应用的调整项单独列为“不针对应用的调整”；
- 明细：每一行包括应用、类型（月费、按量、调整）、项目（月费或计量项）、套餐、日期区间和天数、用量、包含量、计费数量、金额和说明，如“消息数超出 164.52 万条”。月费行的“用量”是天数。
调整项是我们在出账前加入的补收（正数）或减免（负数），如服务故障的补偿，说明中写明原因。
已出账的账单不会修改。金额有误时，我们会作废后重新出具，或者在之后的账单中加入调整项。
导出明细
在账单详情中点击“导出明细”，下载这张账单的全部明细，文件名为账单编号，如 6195295143-202609.csv。文件为 UTF-8 编码（带 BOM，可以直接用 Excel 打开），各列为：账单编号、账期、应用、类型、计量项、套餐编码、套餐名称、开始日期、结束日期、天数、用量、包含量、计费数量、计价单位、单价（元）、金额（元）、说明。
- 金额以元为单位，保留两位小数，减免为负数；
- “计量项”为计量项的标识，如
messages（消息数）、dau（日活）； - 应用名、套餐名称和说明以
=、+、-、@开头时，前面加一个单引号，避免被表格软件当作公式。
流水
“费用中心”的“流水”按时间倒序列出余额的每一次变化，可以按种类筛选：
| 种类 | 说明 |
|---|---|
| 收款 | 我们核对到账后记录的转账，金额计入余额 |
| 账单扣款 | 用余额结清账单，“账单”一列为结清的账单编号 |
| 作废退回 | 账单作废后，退回已经扣除的金额 |
| 退款 | 我们把余额退还给你 |
| 赠送 | 我们向余额赠送的金额，如服务故障的补偿，备注中写明原因 |
| 冲正 | 记错的收款、退款或赠送不会修改或删除，而是记一条金额相反的冲正记录，原记录标有“已冲正” |
每一行显示时间（收款和退款为到账时间）、种类、金额、这次变化之后的余额、方式和凭证号（如银行流水号）、账单编号和备注。一笔收款接着结清账单时，会紧跟着一条账单扣款。
用量汇总
“费用中心”的“用量汇总”按月显示各应用的用量，默认为上个月，可以查看本月和之前 13 个月。其中消息数、通话分钟数、聊天室消息数和审核次数为当月合计；日活显示合计（人·天）和单日的最大值；月活为当月的值；并发连接数峰值和存储量为当月的最大值；注册用户数为当月统计到的最大值。
付款
通过银行转账付款，在转账备注中填写账单编号。我们核对到账后记录收款，金额计入余额，随即按账期从早到晚自动结清未付的账单；余额不够时部分结清，账单仍为“已出账”，“已付”金额相应增加。收款记录在“流水”中查看，到账不单独发送通知。
- 预存：可以在出账之前转账，金额留作余额，之后的账单出账时自动扣除，余额足够的账单出账时即结清。签订年度合同一次付清的，同样记入余额、逐月扣除；
- 多付的金额：结清全部账单后剩下的留作余额。需要退还余额时请联系我们，退款金额不超过当前的余额，已经用于结清账单的金额不能直接退回；
- 延期付款：确有困难时，请在付款截止之前联系我们。
账单联系人与通知
owner 和 admin 可以在“账户”中设置账单联系人：输入邮箱后回车，最多 5 个，点击“保存”。邮箱的首尾空格会被去掉、统一转为小写，重复的只保留一个；不验证邮箱的归属。清空后保存，改为通知租户的 owner 和全部 admin。保存时提示“数据已被其他人修改，请刷新后重试”的，刷新页面后重新设置。
以下通知发给账单联系人；没有设置账单联系人时，发给 owner 和全部 admin（有已验证邮箱的发邮件，否则发短信）。通知中的时间为北京时间。
| 通知 | 时间 | 内容 |
|---|---|---|
| 账单已出 | 出账时 | 账期、账单编号、应付金额、已从余额扣除的金额、付款截止时间 |
| 付款提醒 | 付款截止前 3 天，以及截止后 1 天 | 账单编号、未付金额、付款截止时间 |
| 即将限制服务 | 只读、暂停生效前 3 天 | 未付金额、将要采取的限制和时间 |
| 服务已限制 | 服务变为只读、暂停时 | 限制的内容、逾期金额。另外以短信通知 owner 已验证的手机号 |
| 服务已恢复 | 解除限制时 | 解除的原因 |
已经过时的通知不再发送，例如账单已经付清后不再发送付款提醒。
逾期与欠费
已出账的账单过了付款截止时间仍未付清即为逾期。逾期后的处理从最早一张逾期账单的付款截止时间起算，默认的时间如下，与我们另有约定的以合同为准：
| 付款截止后 | 处理 |
|---|---|
| 1 天 | 逾期提醒 |
| 12 天 | 提醒：3 天后服务将变为只读 |
| 15 天 | 租户的全部应用变为只读 |
| 27 天 | 提醒：3 天后将暂停服务 |
| 30 天 | 暂停租户的服务 |
服务受到限制时，“费用中心”的“账户”顶部显示“因欠费，全部应用已变为只读”或“因欠费，服务已暂停”，以及原因，如“账单 6195295143-202609 逾期 15 天”。受限制期间照常计费。
只读和暂停对服务端和客户端的影响见应用和租户的状态，概括如下：
- 只读：用户保持连接，可以登录和查看消息，但不能发送消息；服务端和控制台中新增数据、修改资料的操作（如创建用户、建群、发送消息）返回
403 app_unavailable，details.reason为arrears；查询以及封禁、禁言、删除等处置操作照常。控制台中修改应用信息、运行策略、服务端凭据和账单联系人等管理操作不受影响； - 暂停：全部应用停止服务，已签发的 App Token 和客户端的 User Token 全部失效，在线的客户端被断开；换取 App Token 返回
403 tenant_unavailable，details.reason为arrears。控制台仍可登录和查看，包括账户、账单和流水，但不能修改设置（包括账单联系人），见租户状态。
恢复服务
逾期的账单全部结清后，只读和暂停自动解除，通常在记录收款后几秒内生效，并发送“服务已恢复”的通知。只结清了一部分的，按剩下最早的一张逾期账单重新计算，限制可能保持不变。
- 只读解除后，写操作随即恢复正常，不需要额外处理；
- 暂停解除后，服务端重新换取 App Token 即可，Client ID 和 Client Secret 不变；客户端续期令牌即可继续使用，不必重新登录，但暂停时间超过登录有效期（默认 7 天）的用户需要重新登录。
如果租户同时因其他原因被平台暂停，结清欠费后仍处于暂停状态，请联系我们。
权限
| 操作 | owner | admin | developer |
|---|---|---|---|
| 查看可选的套餐，查看应用的套餐、额度、套餐变更历史和每日用量 | ✓ | ✓ | ✓ |
| 查看账户、本月费用预估、账单和明细、流水、用量汇总，导出明细 | ✓ | ✓ | |
| 设置账单联系人 | ✓ | ✓ |
这些操作都不需要重新验证身份。设置账单联系人会写入操作日志，查看不记录。
注销租户之后
租户注销后，控制台中看不到这个租户和它的账单。最后一个月的费用在下月初照常出账，通知发给原来的账单联系人（没有设置的发给原来的 owner 和 admin）；需要账单明细或退还余额时，请联系我们。
独立频道用量与自动更正
| 计量项 | 口径 |
|---|---|
| rtc_channel_audio_minutes | 音频频道实际参与时长；按应用、统计日汇总后向上取整到分钟 |
| rtc_channel_video_minutes | 视频频道同口径；关闭摄像头仍按视频统计 |
发布者和订阅者均计入。准备占位不计为媒体参与；跨日按统计时区拆分，估计毫秒已包含在总毫秒中。原通话每次每人分别取整的规则不变，不能套用到频道。套餐未配置频道计量项时不自动套用原通话价格。
通话与活跃频道媒体代次共用并发额度，频道不按每个参与者扣一个额度；正在媒体清理的资源仍可能占用额度。
用量只采集已定稿日期。迟到证明形成版本化更正，按原账期历史订阅、包含量与舍入计算差额。原账期草稿在生成 / 重算时纳入；原账期已出账或结清则保留旧账单，差额计入下一期或更晚可用草稿。confirmed 只代表计费已接收，不代表已出账或结清。
已有草稿需重算；减免最多抵到应付为 0，未抵完部分和超过单张账单 100 条调整上限的余额继续结转。自动调整不能人工删除，作废释放分配后保留余额。历史手工补偿须核对以避免重复。统计和更正查询见频道用量接口。