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

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

QPS（Queries-Per-Second）指每秒查询率，默认情况下，声网互动白板文档转换服务只能同时处理一个文档转换请求（即 QPS 为 1），在前一个转换完成后才会进行第二个任务的转换，并按成功转换的页数计费。

如果你的某个白板项目每秒并发请求数量较大，默认的 QPS 无法满足你的需求，你可以[联系销售](https://www.shengwang.cn/contact-sales/)，申请调整该项目的 QPS 配置并按 QPS 计费。

## 配置 QPS [#配置-qps]

[联系销售](https://www.shengwang.cn/contact-sales/) 配置按 QPS 计费时，你需要提供以下信息：

- 需要调整 QPS 的白板项目的 AppIdentifier。获取方式详见[获取互动白板项目的安全密钥](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/enable-service)。

- 文档转换服务所属的数据中心。请确保你已开启该数据中心下的文档转换服务，详见[开启互动白板配套服务](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/enable-service)。

:::info[信息]
- 如果该白板项目下有多个数据中心开启了文档转换服务，指定数据中心的 QPS 配置生效后，该项目下其他数据中心的文档转换服务也将切换为按 QPS 计费，QPS 值为 1。
- 如果你不需要使用其他数据中心的文档转换服务且不希望支付额外费用，可以关闭这些数据中心的文档转换服务。
- 如果你需要使用其他数据中心的文档转换服务且并发请求数量大，可以单独为这些数据中心配置 QPS。
:::

- 文档转图片需要的每日 QPS，必须为正整数。

- 文档转网页需要的每日 QPS，必须为正整数。

- 期望的生效日期。

QPS 配置通常会在一个小时内完成并生效。声网支持动态调整 QPS，当你预期项目的并发请求数激增时，可以提前一天[联系销售](https://www.shengwang.cn/contact-sales/) 修改已配置的 QPS。

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

对于每个按 QPS 计费的白板项目，声网统计月平均 QPS 之和，并乘以单价，得出每月费用，具体如下：

<DocsTable>
<thead>
<tr>
<th scope="col">**文档转换服务**</th>
<th scope="col">**月平均 QPS\***</th>
<th scope="col">**单价**</th>
<th scope="col">**费用**</th>
</tr>
</thead>
<tbody>
<tr>
<td>文档转图片</td>
<td>日 QPS 之和/月自然天数</td>
<td rowSpan={2}>600 元/QPS</td>
<td rowSpan={2}>月平均 QPS 之和 × 600</td>
</tr>
<tr>
<td>文档转网页</td>
<td>日 QPS 之和/月自然天数</td>
</tr>
</tbody>
</DocsTable>

:::warning[注意]
- 计算月平均 QPS 时，小数位四舍五入，仅保留整数。
- 如果你的白板项目下有多个数据中心开启了文档转换服务，则需要将每个数据中心的月平均 QPS 相加，得出月平均 QPS 之和。
- 如果你的账号下有多个白板项目配置了按 QPS 计费，则每月文档转换总费用等于每个项目的文档转换费用之和。
:::

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

假设你开启了白板项目 A 下杭州数据中心的文档转换服务，并保持该项目下其他数据中心下的文档转换服务为关闭状态。由于你预期该项目的文档转换并发请求数将激增，故[联系销售](https://www.shengwang.cn/contact-sales/) 并提供以下信息申请提高该项目的 QPS 配置：

- 白板项目 A 的 AppIdentifier。
- 数据中心：中国杭州。
- 文档转图片每日 QPS：5。
- 文档转网页每日 QPS：10。
- 生效日期：从 2022 年 4 月 1 日起生效。

配置生效后，声网即每月按 QPS 对该项目使用的文档转换服务收取费用。4 月的费用计算如下：

<DocsTable>
<thead>
<tr>
<th scope="col">**文档转换服务**</th>
<th scope="col">**日 QPS**</th>
<th scope="col">**当月天数**</th>
<th scope="col">**月平均 QPS**</th>
<th scope="col">**单价**</th>
<th scope="col">**费用**</th>
</tr>
</thead>
<tbody>
<tr>
<td>文档转图片</td>
<td>5</td>
<td>30</td>
<td>(5 × 30)/30 = 5</td>
<td rowSpan={2}>600 元/QPS</td>
<td rowSpan={2}>(5 + 10 ) × 600 = 9,000 元</td>
</tr>
<tr>
<td>文档转网页</td>
<td>10</td>
<td>30</td>
<td>(10 × 30)/30 = 10</td>
</tr>
</tbody>
</DocsTable>

4 月中，如果你发现上述 QPS 配置仍然无法满足业务需求，再次[联系销售](https://www.shengwang.cn/contact-sales/) 申请将该项目的文档转图片 QPS 从 5 提高至 11，4 月 11 日生效。

声网会按动态调整后的 QPS 重新计算月 QPS 之和，并计算月度费用。4 月的费用计算如下：

<DocsTable>
<thead>
<tr>
<th scope="col">**文档转换服务**</th>
<th scope="col">**日 QPS**</th>
<th scope="col">**当月天数**</th>
<th scope="col">**月平均 QPS**</th>
<th scope="col">**单价**</th>
<th scope="col">**费用**</th>
</tr>
</thead>
<tbody>
<tr>
<td>文档转图片</td>
<td>

- 4.1 - 4.10：5
- 4.11 - 4.30：11

</td>
<td>30</td>
<td>(5 × 10 + 11 × 20)/30 = 9</td>
<td rowSpan={2}>600 元/QPS</td>
<td rowSpan={2}>(9 + 10) × 600 = 11,400 元</td>
</tr>
<tr>
<td>文档转网页</td>
<td>10</td>
<td>30</td>
<td>(10 × 30)/30 = 10</td>
</tr>
</tbody>
</DocsTable>

## 注意事项 [#注意事项]

当你为白板项目申请文档转换服务按 QPS 计费时，你需要注意以下事项：

- QPS 计费和页数计费是互斥的，一个项目只能选择一种计费方式。
- 成功配置按 QPS 计费的白板项目产生的文档转换用量，不再计入月累计转换页数，也不再享有免费额度。
- 配置按 QPS 计费后，月账单会与默认账单不同，实际计费信息以合同为准。