# 计费说明 (/zh-CN/realtime-media/whiteboard/fastboard-sdk/reference/billing)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

本文展示声网互动白板的计费方式。

:::warning[注意]
如果你已与我们的销售签约，则实际计费信息以合同为准。
:::

## 概述 [#概述]

当你在项目中开通并使用了声网互动白板，声网会收取费用，并按月发布账单、进行扣款。详见[账单、扣费与账户冻结](/zh-CN/reference/faq/account/billing_account)。

## 费用组成 [#费用组成]

声网互动白板提供以下服务：

- 互动白板
- 白板录制
- 文档转换
  - 文档转图片
  - 文档转网页

每月结束时，声网会统计[你的开发者账户](https://console.shengwang.cn/)下所有项目产生的各项互动白板服务的用量，减去每月免费额度，乘以相应的单价，将各项服务的费用相加，得出本月总费用。

**月总费用 = 互动白板费用 + 白板录制费用 + 文档转图片费用 + 文档转网页费用**

声网互动白板各项服务的单价、免费额度和费用计算方式如下：

<DocsTable>
<thead>
<tr>
<th scope="col">**声网互动白板服务**</th>
<th scope="col">**用量统计维度**</th>
<th scope="col">**单价**</th>
<th scope="col">**免费额度**</th>
<th scope="col">**费用**</th>
</tr>
</thead>
<tbody>
<tr>
<td>互动白板</td>
<td rowSpan={2}>时长（分钟数）</td>
<td>9.6 元/千分钟</td>
<td>每月前 10000 分钟免费</td>
<td>(月累计分钟数 - 10000) × 9.6/1000</td>
</tr>
<tr>
<td>白板录制</td>
<td>12 元/千分钟</td>
<td>每月前 1000 分钟免费</td>
<td>(月累计分钟数 - 1000) × 12/1000</td>
</tr>
<tr>
<td rowSpan={2}>

文档转换
（标准计费）

</td>
<td rowSpan={2}>

页数
（1 张网页 = 5 张图片）

</td>
<td rowSpan={2}>3 元/千页</td>
<td rowSpan={2}>每月前 1000 张图片免费</td>
<td rowSpan={2}>(月累计转换图片页数 + 月累计转换网页页数 × 5 - 1000) × 3/1000</td>
</tr>
<tr />
<tr>
<td>

文档转换
（QPS 计费）

</td>
<td>

月平均 QPS
 (日 QPS 之和/月自然天数)

</td>
<td>600 元/QPS/月</td>
<td>/</td>
<td>月平均 QPS × 600</td>
</tr>
</tbody>
</DocsTable>

:::warning[注意]
- 文档转换服务分为**文档转网页**和**文档转图片**两种方式，文档转网页的实际费用是文档转图片的 5 倍。在计费时，声网会将文档转网页的用量转换成文档转图片的用量，即文档转网页总页数 × 5。
- 文档转换服务可以单独配置 QPS 并按 QPS 计费。详见[文档转换服务按 QPS 计费](/zh-CN/realtime-media/whiteboard/fastboard-sdk/reference/qps-pricing)。
- QPS 计费和标准计费是互斥的，一个项目只能选择一种计费方式。
- 声网会将每月的总费用四舍五入，精确到小数点后两位。
- 如果某项互动白板服务的月累计用量未超过免费额度，则当月该项服务免费。剩余的免费额度会在月底清零。
:::

### 用量计算 [#用量计算]

本节介绍声网互动白板各项服务的计量方式。

#### 互动白板 [#互动白板]

对于互动白板的用量，声网根据互动白板房间的人数计算，即每个互动白板房间的用量为该房间内**所有用户产生的时长之和**。

针对每个用户，声网从其加入互动白板房间开始计时，到离开这个房间结束计时。**用量的精度为分钟**。

#### 白板录制 [#白板录制]

针对白板录制，创建互动白板房间时开启了录制功能后，声网会从第一个用户加入该房间开始计时，到所有用户离开房间停止计时。**用量的精度为分钟**。

当房间空闲，即房间内无用户时，声网会自动暂停计时，当有用户加入时继续计时。

#### 文档转换 [#文档转换]

针对文档转换，声网根据成功转换后的图片或网页数量计算用量。文档转换服务可以单独配置 QPS 并按 QPS 计费。详见[文档转换服务按 QPS 计费](/zh-CN/realtime-media/whiteboard/fastboard-sdk/reference/qps-pricing)。

在计费时，声网会将文档转网页的用量转换成文档转图片的用量，即文档转网页总页数 × 5。如果文档转换任务失败，则声网不会统计该任务产生的用量。

### 用量查看 [#用量查看]

声网控制台提供产品用量查看功能，你可以参照以下步骤查看互动白板用量：

1. 登录[声网控制台](https://console.shengwang.cn/)，点击左侧导航栏的**用量**按钮。

2. 点击页面左上角**聚合用量**旁的箭头 <InlineImage alt="展开项目列表" src="https://web-cdn.agora.io/docs-files/1607311735894" height={25} />，在下拉框中选择需要查看的项目名称。

3. 在指定项目下，点击**白板**下的**分钟数**或**文档转换**，设置需要查看的时间段，查看互动白板的时长用量和文档转换用量。

:::warning[注意]
- 时间段范围不能超过 12 个月。
- 角色为管理员或财务的声网开发者账户拥有查看用量统计页面的权限。
- 声网控制台展示的用量仅供参考，实际用量以账单为准。
:::

## 计费示例 [#计费示例]

本节展示如何统计一个声网开发者账号下整月的互动白板用量，并根据相应单价，计算总费用。

### 场景描述 [#场景描述]

假设你的声网开发者账号下有一个启用了互动白板的项目，项目名为 Test，该项目在 2021 年 2 月 1 日 到 2 月 28 日之间使用互动白板服务的情况如下：

#### 场景一 [#场景一]

2021 年 2 月 8 日，用户 A 和用户 B 同时加入互动白板房间，用户 A 对用户 B 进行 45 分钟的教学。在此期间，用户 A 使用文档转换服务成功将 30 页的 PDF 转换为 PNG 图片并在白板中展示。课程结束后，用户 A 和用户 B 同时离开白板房间。

用量统计如下：

| 计费项 | 用量 |
| --- | --- |
| 互动白板 | [billing-html-1-1-1 details](#table-slot-billing-html-1-1-1) |
| 文档转图片 | 30 页 |

<a id="table-slot-billing-html-1-1-1"></a>

**billing-html-1-1-1 details**

- 用户 A：45 分钟
- 用户 B：45 分钟

####  场景二 [#场景二]

2021 年 2 月 11 日，用户 A 加入互动白板房间进行在线公开授课，并使用文档转换服务成功将 50 页的动态 PPT 转换为 HTML 网页在白板中展示。200 名用户加入该房间实时观看。公开课持续 60 分钟，并使用白板录制服务录制了整个过程。

用量统计如下：

| 计费项 | 用量 |
| --- | --- |
| 互动白板 | [billing-html-2-1-1 details](#table-slot-billing-html-2-1-1) |
| 文档转网页 | 50 页 |
| 白板录制 | 60 分钟 |

<a id="table-slot-billing-html-2-1-1"></a>

**billing-html-2-1-1 details**

- 用户 A：60 分钟
- 200 名用户：60 × 200 分钟

### 费用计算 [#费用计算]

<DocsTable>
<thead>
<tr>
<th rowSpan={2} scope="col">**日期**</th>
<th colSpan={4} scope="colgroup">**用量**</th>
</tr>
<tr>
<th scope="col">互动白板（分钟数）</th>
<th scope="col">白板录制（分钟数）</th>
<th scope="col">文档转图片（页数）</th>
<th scope="col">文档转网页（页数）</th>
</tr>
</thead>
<tbody>
<tr>
<td>2021-02-08</td>
<td>90</td>
<td>0</td>
<td>30</td>
<td>0</td>
</tr>
<tr>
<td>2021-02-11</td>
<td>12,060</td>
<td>60</td>
<td>0</td>
<td>50</td>
</tr>
<tr>
<td>月累计用量</td>
<td>12,150</td>
<td>60</td>
<td>30</td>
<td>50</td>
</tr>
<tr>
<td>入账用量</td>
<td>12,150</td>
<td>60</td>
<td>30</td>
<td>50 × 5 = 250</td>
</tr>
<tr>
<td>免费额度</td>
<td>10,000</td>
<td>1,000</td>
<td colSpan={2}>共享 1,000 张图片额度（1 张网页 = 5 张图片）</td>
</tr>
<tr>
<td>计费（元）</td>
<td>(12,150 - 10,000)/1,000 × 9.6 = 20.64</td>
<td>0</td>
<td colSpan={2}>0</td>
</tr>
<tr>
<td>合计（元）</td>
<td colSpan={4}>20.64</td>
</tr>
</tbody>
</DocsTable>

## 常见问题 [#常见问题]

<Accordions>
<Accordion title="如果直播结束，但用户没有退出房间，是否会一直计费？">

会计费，因为白板底层只根据是否有活跃长连接来计算用量。因此，为避免产生额外费用，声网建议：

- 在用户离开房间时，调用 `disconnect()` 断开与当前房间的连接，并确保收到 `onPhaseChanged(disconnected)` 回调。
- 直播结束时在 App 服务端调用[封禁房间](/zh-CN/api-reference/api-ref/whiteboard/restful/ban-room)强制所有人退出房间。

</Accordion>

<Accordion title="是否从创建房间就开始计费？">

不是，创建的房间中没有用户时不计时，因此不会产生费用。

</Accordion>

<Accordion title="使用不同的模式加入房间，是否会导致收费不同？">

不会，无论用户是以互动模式还是订阅模式加入房间，其产生的用量和单价都一样。

</Accordion>
</Accordions>