# 配额限制 (/zh-CN/realtime-media/media-pull/reference/quota)

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

本文介绍输入在线媒体流的配额限制。

<a id="pcw"></a>
## 峰值并发任务数 [#峰值并发任务数]

峰值并发任务数 (PCW, Peak Concurrent Workload) 指最大并发任务数。PCW 限制与你使用声网服务处理的视频流分辨率和所在地区有关，详见下表：

| 分辨率 | 中国大陆 | 欧洲 | 美洲 | 亚太（除去中国大陆） |
| --- | --- | --- | --- | --- |
| 标清 (≤ 640 × 360) | 20 | 20 | 20 | 20 |
| 高清 (≤ 1280 × 720) | 20 | 10 | 10 | 20 |
| 全高清 (≤ 1920 × 1080) | 10 | 5 | 5 | 5 |

<a id="api-限速"></a>

## 调用频率限制 [#调用频率限制]

声网服务器限制你的输入在线媒体流服务 API 调用速率，超出限制速率时会返回状态码 `429 (Too Many Requests)`。

在有并发任务场景下，输入在线媒体流服务的每秒请求数不能超过最大并发任务数的 10%。

下表展示各 API 调用频率限制：

| API | 调用频率限制 |
| --- | --- |
| `Create` | [quota-markdown-2-1-1 details](#table-slot-quota-markdown-2-1-1) |
| `Update` | [quota-markdown-2-2-1 details](#table-slot-quota-markdown-2-2-1) |
| `Delete` | 一个项目中，销毁云端播放器的速率上限为 100 次/秒。 |
| `List` | [quota-markdown-2-4-1 details](#table-slot-quota-markdown-2-4-1) |

<a id="table-slot-quota-markdown-2-1-1"></a>

**quota-markdown-2-1-1 details**

根据创建的播放器是否有名字，限流情况不同：

- 一个项目中，创建有名字（`name`）的云端播放器时，每个不同名字的云端播放器的创建速率上限为 2 次/秒。
- 一个项目中，创建没有名字（`name`）的云端播放器时，云端播放器的创建速率上限为 50 次/秒。

<a id="table-slot-quota-markdown-2-2-1"></a>

**quota-markdown-2-2-1 details**

根据更新的播放器是否有名字，限流情况不同：

- 一个项目中，更新有名字（`name`）的云端播放器时，每个不同名字的云端播放器的更新速率上限为 2 次/秒。
- 一个项目中，更新没有名字（`name`）的云端播放器时，云端播放器的更新速率上限为 50 次/秒。

<a id="table-slot-quota-markdown-2-4-1"></a>

**quota-markdown-2-4-1 details**

根据查询时是否设置过滤条件，限流情况不同：

- 一个项目中，有过滤条件（`filter`）时，查询速率上限为 2 次/秒 和 15 次/分钟。
- 一个项目中，没有过滤条件（`filter`）时，查询速率上限为 10 次/秒和 20 次/分钟。

## 拉流分辨率和路数限制 [#拉流分辨率和路数限制]

声网支持往频道内拉流的最大视频分辨率为 1920 × 1080，帧率为 30 fps。

输入在线媒体流服务在不同地区支持的拉流路数限制信息详见下表：

| 分辨率 | 中国大陆 | 欧洲 | 美洲 | 亚太（除去中国大陆） |
| --- | --- | --- | --- | --- |
| 标清 (≤ 640 × 360) | 20 | 20 | 20 | 20 |
| 高清 (≤ 1280 × 720) | 20 | 10 | 10 | 20 |
| 全高清 (≤ 1920 × 1080) | 10 | 5 | 5 | 5 |

如果你需要同时拉多种档位的流，则确保同时满足如下要求：

- 总路数不能超过所支持档位的最大路数。
- 各档位拉流路数不能超过该档位支持的最大路数。

例如，如果你需要在中国大陆使用输入在线媒体流服务，并且同时拉流高清和全高清视频，则高清拉流路数不能超过 20，全高清拉流路数不能超过 10，拉流总路数不能超过 20。

## 提升配额 [#提升配额]

如果你想提升配额，可以[联系技术支持](https://ticket.shengwang.cn/)。
