使用限制
本页汇总各项功能的数量上限、长度限制、频率限制和默认值，供选型和设计时参考。表中“调整方式”一列的含义：
- 运行策略：租户或应用可以在控制台的运行策略中修改，括号中为可设置的范围；
- 配额：平台为每个应用设置的保护性上限，需要提高时请联系我们，见限流与应用状态；
- 套餐：由应用的套餐决定，在控制台应用详情的“套餐与用量”中查看，需要提高时请联系我们更换套餐，见套餐与账单；
- 固定：不能调整。
说明：
- “个字符”按 Unicode 字符计算，一个汉字算一个字符；“字节”和“KB”按 UTF-8 编码计算，1 KB 为 1024 字节。
- “每分钟 N 次”“每天 N 次”这类频率限制允许突发：可以连续用完 N 次，之后匀速恢复，含义见限流的计算方式。
- 标为“客户端”的频率限制只对用户在客户端的操作生效，服务端通过 REST API 代用户操作时不受这些限制；标为“控制台”的只限制控制台中的操作。
- 调低上限（包括更换为额度更低的套餐）不影响已有的数据，例如调低群人数上限后，已经超出的群不会移出成员，只是不能再加人。保留天数是例外：调短消息、附件或群文件的保留天数后，超出保留期的数据随即开始删除，不能恢复。
用户
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个应用的注册用户数（未删除的用户，含已封禁的） | 由套餐决定，默认套餐为 10 万 | 套餐 |
| 用户名 | 1 到 64 个字符，由字母、数字和 _、-、. 组成，不区分大小写 | 固定 |
| 昵称 | 64 个字符 | 固定 |
| 头像地址 | 512 字节 | 固定 |
| 用户的自定义属性 | 32 项，键为 1 到 32 个字符，JSON 编码后合计不超过 4 KB | 固定 |
| 密码 | 1 到 64 个字符 | 固定 |
| 封禁、全局禁言的时长 | 1 秒到 10 年，或永久 | 固定 |
| 封禁、禁言等操作的原因 | 256 个字符 | 固定 |
| 每个用户同时登录的设备数 | 4 台 | 运行策略 max_online_devices_per_user（1 到 20），还可以按平台分组分别限制（device_limits_by_platform） |
| 登录设备超出上限时 | 踢掉最早登录的设备 | 运行策略 device_overflow_policy（踢掉最早的设备，或拒绝新设备登录） |
| User Token 的有效期 | 1 天 | 运行策略 user_token_ttl_seconds（5 分钟到 1 年，或不过期） |
| refresh token 的有效期 | 7 天 | 运行策略 user_refresh_ttl_seconds（1 小时到 1 年） |
| 登录凭证 | 5 分钟内有效，只能使用一次 | 固定 |
| 批量创建用户 | 一次 100 个 | 固定 |
| 计算密码哈希（带密码创建用户、设置密码、密码登录） | 每个应用每秒 100 次，服务端和客户端各一份 | 固定 |
| 客户端：自注册 | 每个 IP 每分钟 10 次 | 固定 |
| 客户端：登录 | 每个 IP 每分钟 120 次 | 固定 |
| 客户端：修改本人资料 | 每个用户每分钟 20 次 | 固定 |
| 客户端：查询其他用户的资料 | 每个用户每分钟 600 个用户 | 固定 |
好友与黑名单
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个用户的好友数 | 3000 | 运行策略 friend_limit（1 到 10 万） |
| 每个用户的黑名单 | 1000 人 | 固定 |
| 好友备注 | 64 个字符 | 固定 |
| 好友的自定义属性 | 16 项，键为 1 到 32 个字符，JSON 编码后合计不超过 1 KB | 固定 |
| 添加来源 | 32 个字符 | 固定 |
| 好友申请的附言 | 256 个字符 | 固定 |
| 待处理的好友申请 | 最近一次发送后 30 天过期 | 固定 |
| 好友申请的记录 | 最近一次发送后保留 60 天 | 固定 |
| 申请被拒绝后再次申请 | 24 小时后才能再向对方申请 | 固定 |
| 批量添加、删除好友，批量拉黑、移出黑名单，检查好友关系 | 一次 100 个用户 | 固定 |
| 好友列表、黑名单每页 | 默认 100 个，最多 500 个 | 固定 |
| 客户端：发送好友申请 | 每个用户每分钟 20 个、每天 500 个；向同一个人每天 5 次 | 固定 |
| 客户端：其他好友和黑名单操作（同意、拒绝、删除、修改备注、拉黑等） | 每个用户每分钟合计 60 次 | 固定 |
| 客户端：检查好友关系 | 每个用户每分钟 600 个用户 | 固定 |
群组
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个群的人数（含群主） | 500 人 | 运行策略 max_group_members（2 到 5000），且不超过套餐的额度；还可以为单个群设置更小的上限（2 到 5000），取其中最小的 |
| 每个用户加入的群数（含自己是群主的） | 500 个 | 运行策略 max_groups_per_user（1 到 5000），且不超过套餐的额度 |
| 每个应用的群数（未解散的） | 由套餐决定，默认套餐不限 | 套餐 |
| 每个群的管理员 | 20 人 | 固定 |
| 每个群的黑名单 | 1000 人 | 固定 |
| 群名称、群昵称 | 64 个字符 | 固定 |
| 群简介 | 512 个字符 | 固定 |
| 群头像地址 | 512 字节 | 固定 |
| 群公告 | 2048 个字符 | 固定 |
| 群的自定义属性 | 32 项，键为 1 到 32 个字符，JSON 编码后合计不超过 4 KB | 固定 |
| 成员属性 | 16 项，JSON 编码后合计不超过 1 KB | 固定 |
| 申请理由、邀请附言、拒绝理由、拉黑和封禁的原因 | 256 个字符 | 固定 |
| 群内禁言的时长 | 1 秒到 10 年，或永久 | 固定 |
| 待处理的入群申请和邀请 | 最近一次发起后 7 天过期 | 固定 |
| 被拒绝后的冷却 | 入群申请被拒绝后，24 小时内不能再申请加入该群；拒绝邀请或主动退群后，24 小时内不能再被邀请进该群。服务端添加成员不受限制 | 固定 |
| 入群链接的有效期 | 1 到 7 天，默认 7 天 | 生成链接时设置 |
| 一次添加、移出、邀请的成员；一次批量获取的群 | 100 个 | 固定 |
| 群成员列表每页 | 默认 100 个，最多 500 个 | 固定 |
| 每个群的入群速度 | 每分钟 60 人；服务端添加的成员和建群时的初始成员不计入 | 固定 |
| 客户端：建群 | 每个用户每分钟 5 个、每天 50 个 | 固定 |
| 客户端：邀请入群 | 每个用户每分钟 100 人、每天 500 人 | 固定 |
| 客户端：申请入群 | 每个用户每分钟 20 次，同一个群每天 5 次 | 固定 |
| 客户端：其他群操作 | 每个用户每分钟合计 60 次 | 固定 |
消息与会话
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
单条消息的大小（类型、body、ext 等内容按 JSON 编码后合计） | 5 KB | 运行策略 max_message_body_bytes（1 KB 到 32 KB） |
消息的推送设置 push | 2 KB | 固定 |
client_msg_id | 1 到 64 个可见 ASCII 字符 | 固定 |
| 一条消息 @ 的人数 | 20 人 | 固定 |
| 批量发送一次的接收人数 | 600 人 | 运行策略 max_recipients_per_message（1 到 1000） |
| 每条消息的表情回应种类 | 20 种 | 运行策略 max_reactions_per_message（1 到 50） |
| 每个会话的置顶消息 | 20 条 | 运行策略 max_pinned_messages_per_conversation（1 到 100） |
| 每个用户的置顶会话 | 100 个 | 固定 |
| 发送者撤回消息的时限 | 2 分钟 | 运行策略 recall_window_seconds（0 到 7 天，0 表示发送者不能撤回）；服务端和群主撤回不受这个时限限制 |
| 服务端编辑一条消息 | 最多 100 次 | 固定 |
| 历史消息的保存时间 | 90 天 | 运行策略 message_retention_days（1 到 3650 天），且不超过套餐的消息保留天数 |
| 重新连接后补齐的离线消息 | 每个会话最近的单聊 500 条、群聊 200 条，且在 7 天以内；更早的消息向前翻页时再拉取 | 运行策略 offline_single_message_limit、offline_group_message_limit（1 到 10000），offline_message_retention_days（1 到 30 天） |
| 一次拉取的消息 | 默认 20 条，最多 100 条 | 固定 |
| 一次导出的消息 | 默认 100 条，最多 1000 条 | 固定 |
| 返回消息的接口一次响应的大小 | 消息合计不超过 1 MB，超出的留到下一页 | 固定 |
| 一次删除的消息、一次批量撤回的消息 | 100 条 | 固定 |
| 全部已读、未读总数的统计范围 | 所在的全部群，以及按最近消息排序的前 1000 个单聊和已离开的群 | 固定 |
| “正在输入”的提示 | 单聊和 100 人以内的群 | 固定 |
| 群消息已读回执的实时通知 | 500 人以内的群 | 固定 |
| 每个群的消息速度 | 每秒 40 条，客户端和服务端发送的合计 | 固定 |
| 每个应用的消息速度 | 每分钟 30000 条，客户端和服务端发送的合计，批量发送按接收人数计算 | 配额 |
| 客户端：发送消息 | 每个用户每秒 10 条（突发 20 条）；同一个单聊中每秒 5 条；每个用户每秒最多收到 50 条单聊消息 | 固定 |
| 客户端：给没有聊过的人发消息 | 每个用户每分钟 20 人、每天 200 人 | 固定 |
| 客户端：@ | 每个用户每分钟 60 人次，@ 全体成员计为 20 人次 | 固定 |
文件
“MB”“GB”按 1024 进位计算，如 1 MB 为 1048576 字节。
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 应用的存储额度（附件、头像、聊天室封面和群文件合计，含缩略图） | 平台配额 storage_limit_gb（默认 1024 GB）与套餐的存储容量中较小的一个。超出后不能再上传，已有的文件不受影响 | 配额、套餐 |
| 消息附件和群文件的大小 | 100 MB | 运行策略 max_upload_bytes（1 MB 到 2 GB） |
图片（附件和群文件中类型为 image 的） | 20 MB，max_upload_bytes 更小时取它；不超过 5000 万像素。更大的图片可以作为 file 类型上传 | 固定 |
| 语音 | 5 MB，max_upload_bytes 更小时取它 | 固定 |
| 用户头像、群头像、聊天室封面（上传的原图） | 5 MB，不超过 5000 万像素；保存为长边不超过 640 像素的图片 | 固定 |
| 文件名 | 255 个字符 | 固定 |
| 一次上传的大小 | 32 MB 以内一次上传；更大的文件分片上传，每片 16 MB | 固定 |
| 上传的有效期 | 创建上传后，32 MB 以内的 1 小时内、分片上传的 24 小时内要完成 | 固定 |
| 附件的保留时间 | 从上传时起 30 天 | 运行策略 attachment_retention_days（1 到 3650 天） |
| 群文件的保留时间 | 不过期，群解散时删除 | 运行策略 group_file_retention_days（0 到 3650 天，0 为不过期） |
| 每个群的群文件数 | 1000 个 | 固定 |
| 头像和聊天室封面的文件 | 上传后 24 小时内没有使用的删除；被替换 7 天后删除；聊天室封面在聊天室解散 7 天后删除 | 固定 |
| 图片的缩略图 | 长边 480 像素 | 固定 |
| 一次换取的下载地址 | 100 个 | 固定 |
| 下载地址的有效期 | 60 到 90 分钟 | 固定 |
| 地址限制中允许的外部主机 | 20 个 | 运行策略 media_allowed_hosts |
| 客户端：创建上传 | 每个用户每分钟 60 次、每天 1000 次 | 固定 |
| 客户端：上传的数据量 | 每个用户每天 2 GB，按创建上传时声明的大小计算 | 固定 |
| 客户端：上传头像 | 每个用户每天 20 个，用户头像、群头像和聊天室封面合计 | 固定 |
| 客户端：上传过程中的其他请求（索取分片地址、查询已上传的分片、完成、取消） | 每个用户每分钟合计 300 次 | 固定 |
| 客户端：换取下载地址 | 每个用户每分钟 600 个文件，直接请求文件地址也计入 | 固定 |
| 客户端：查看和删除群文件 | 每个用户每分钟合计 60 次 | 固定 |
聊天室
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个应用的聊天室数（未解散的） | 1 万个 | 配额 chatroom_limit，且不超过套餐的聊天室数 |
| 每个聊天室的人数 | 10 万人，所有者和管理员不受限制 | 运行策略 max_chatroom_members（10 到 50 万）；还可以为单个聊天室设置上限（1 到 50 万），取两者中较小的 |
| 每个聊天室的管理员 | 99 人 | 固定 |
| 每个聊天室的禁言名单、封禁名单 | 各 1 万个未到期的 | 固定 |
| 每个聊天室的白名单 | 500 人 | 固定 |
| 聊天室内禁言、封禁的时长 | 1 秒到 10 年，或永久 | 固定 |
| 名称、简介、公告 | 1 到 128 个字符、512 个字符、2048 个字符 | 固定 |
| 封面地址 | 512 个字符 | 固定 |
| 聊天室属性 | 100 个键；键为 1 到 128 个字符，值最长 4096 字节，键和值合计不超过 16 KB；一次最多设置或删除 20 个键；创建时最多 100 个初始属性 | 固定 |
进入时的 ext | 512 字节 | 固定 |
单条消息的大小（类型、body、ext 合计） | 2 KB | 运行策略 max_chatroom_message_bytes（256 字节到 8 KB） |
| 每个聊天室每秒的消息 | 普通和低优先级合计 40 条，高优先级另有 20 条；客户端和服务端发送的合计 | 普通和低优先级为运行策略 chatroom_msg_per_second（1 到 200）；高优先级固定 |
| 每个应用全部聊天室每秒的消息 | 2000 条，三种优先级都计入 | 配额 |
| 最近的消息 | 最近 50 条，最多保留 24 小时；低优先级的消息不保存 | 运行策略 chatroom_history_size（0 到 200，0 为不保存）；24 小时固定 |
| 推送成员进出通知的聊天室 | 在线人数不超过 100 人的 | 运行策略 chatroom_member_notify_limit（0 到 1000，0 为都不推送） |
| 客户端创建聊天室 | 默认不允许 | 运行策略 client_chatroom_create_enabled |
| 每条长连接同时在的聊天室 | 10 个 | 固定 |
| 连接断开后算作离开 | 15 秒后 | 固定 |
| 每条连接从一个聊天室收到的消息 | 每秒 50 条、128 KB（普通和低优先级），超出的被丢弃 | 固定 |
| 一次移出、禁言、封禁、加入或移出白名单 | 100 个用户 | 固定 |
| 一次批量查询在线人数 | 100 个聊天室 | 固定 |
| 聊天室列表每页 | 默认 20 个，最多 100 个 | 固定 |
| 在线成员列表每页 | 默认 20 个，最多 1000 个；客户端最多 100 个 | 固定 |
| 已解散的聊天室 | 解散后 30 天内仍可以查询 | 固定 |
| 客户端：发送消息 | 每个用户每秒 5 条（突发 10 条） | 固定 |
| 客户端：进入聊天室 | 每条连接每分钟 10 次；每个聊天室每秒 2000 人 | 固定 |
| 客户端：设置、删除属性 | 每个用户每分钟 30 次；每个聊天室每秒 20 次，客户端和服务端合计 | 固定 |
| 客户端：管理操作（禁言、封禁、移出、撤回、修改资料等） | 每个用户每分钟合计 60 次 | 固定 |
| 客户端：查询（成员列表、名单、最近的消息等） | 每个用户每分钟合计 120 次 | 固定 |
| 客户端：创建聊天室 | 每个用户每分钟 5 个、每天 20 个 | 固定 |
音视频
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 音视频通话 | 默认不开启 | 运行策略 rtc_enabled，且应用的套餐包含音视频 |
| 应用同时进行的通话数（含呼叫中） | 由套餐决定，默认套餐不限 | 套餐 |
| 来电的振铃时间 | 60 秒 | 运行策略 rtc_ring_timeout_seconds（20 到 120 秒） |
| 群通话同时在通话中的人数（含发起人） | 16 人 | 运行策略 max_group_call_participants（3 到 32） |
| 发起群通话、在群通话中邀请时一次邀请的人数 | 人数上限减一，最多 31 人 | 固定 |
| 每个群通话累计涉及的成员（含已离开、拒绝、未接听的） | 100 人 | 固定 |
| 同时进行的通话 | 每个用户 1 个；每个群 1 个群通话 | 固定 |
| 通话心跳 | 每 15 秒一次，45 秒没有收到视为掉线 | 固定 |
| 群通话只剩一人 | 持续 60 秒后结束 | 固定 |
| 通话的最长时长 | 12 小时 | 固定 |
| 媒体凭据的有效期 | 15 分钟，到期前续期 | 固定 |
通话的 ext | 16 项，键为 1 到 64 个字符，JSON 编码后不超过 1 KB | 固定 |
client_call_id | 1 到 64 个可见 ASCII 字符 | 固定 |
| 结束通话、移出成员的原因 | 256 个字符 | 固定 |
| 查询正在振铃的来电 | 最多返回 20 个 | 固定 |
| 通话列表每页 | 默认 20 条，最多 100 条；客户端的通话历史最多 50 条 | 固定 |
| 通话统计 | 一次最多查询 92 天 | 固定 |
| 通话的保留时间 | 结束后 180 天 | 固定 |
| 客户端：通话操作 | 按用户限制频率，如发起通话每个用户每分钟 10 次、每天 200 次，见客户端需要做什么 | 固定 |
离线推送
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个应用的推送凭据 | 20 份 | 固定 |
| 每台设备的推送令牌 | 普通令牌 3 个，VoIP 令牌 1 个 | 固定 |
| 推送令牌 | 1 到 512 个可见 ASCII 字符；APNs 的令牌为 64 到 200 位十六进制 | 固定 |
| 每个用户的会话免打扰 | 10000 个 | 固定 |
| 全局免打扰、会话免打扰的时长 | 1 秒到 10 年，或一直有效 | 固定 |
发送消息时 push 中的标题、正文 | 1 到 64 个字符、1 到 256 个字符 | 固定 |
push.ext | JSON 编码后 512 字节 | 固定 |
| 每个应用的通知模板覆盖 | 300 条 | 固定 |
| 每个应用每分钟的推送 | 60000 次，按设备计，超出的不推送 | 配额 push_per_min_limit |
| 消息的推送时效 | 消息发出 30 分钟后才处理到的不再推送 | 固定 |
| 推送在通道中的有效期 | 24 小时，来电为剩余的振铃时间 | 固定 |
| 推送统计 | 保留 180 天，一次最多查询 92 天 | 固定 |
| 控制台：测试推送 | 每个应用每分钟 20 次，同一个用户每分钟 5 次 | 固定 |
| 客户端：登记和注销推送 | 每台设备每分钟合计 10 次；上报角标每台设备每分钟 60 次 | 固定 |
| 客户端：读取、修改推送设置和会话免打扰 | 每个用户每分钟读、写各 60 次 | 固定 |
内容安全
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个应用的词库 | 20 个 | 固定 |
| 词条 | 每个词库 10000 个，应用合计 50000 个 | 固定 |
| 词条的长度（规范化后） | 屏蔽词 2 到 32 个字符，放行词 2 到 64 个字符 | 固定 |
| 一次添加、删除的词条 | 1000 个 | 固定 |
| 每个租户的审核账号 | 5 个 | 固定 |
| 自动处罚规则 | 5 条；时间窗口 1 到 720 小时，违规次数 1 到 1000，处罚时长 1 秒到 10 年或永久 | 固定 |
| 发送前、保存前等待第三方审核的时间 | 800 毫秒 | 审核配置 sync_timeout_ms（200 到 2000 毫秒） |
| 每个字段检查的内容 | 前 32 KB | 固定 |
| 每个应用每分钟进入事后审核的内容 | 6000 个，超出的不审核 | 固定 |
| 平台的审核账号每天为应用审核的次数 | 100000 次 | 联系我们 |
| 检查文本 | 一次最多 10 个字段 | 固定 |
| 批量作出结论 | 一次 100 条 | 固定 |
| 结论的说明 | 256 个字符 | 固定 |
| 审核记录 | 30 天没有处理的自动结束；作出结论后 30 天内可以改判；记录结束 30 天后清空其中的内容，180 天后删除 | 固定 |
| 用户的违规记录 | 保留 180 天 | 固定 |
| 举报的说明、证据 | 说明 500 个字符，证据消息 5 条 | 固定 |
| 代用户举报 | 每个应用每分钟 600 次 | 固定 |
| 客户端：举报 | 每个用户每分钟 5 次、每天 30 次 | 固定 |
| 控制台：查看审核记录的内容 | 每个成员每分钟 120 次 | 固定 |
| 控制台：试一试 | 每个成员每分钟 60 次 | 固定 |
在线状态与连接
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 客户端查看他人的在线状态 | 默认关闭；开启后默认只能看好友的 | 运行策略 presence_enabled、presence_scope（只看好友，或应用内任何用户）；服务端查询不受这两项限制 |
| 一次查询在线状态 | 100 人 | 固定 |
| 每条连接订阅在线状态 | 3000 人，一次最多订阅 500 人 | 固定 |
| 最近离线时间 | 保留 30 天，30 天内没有上线过的用户为 null | 固定 |
| 发现设备异常断线 | 前台最迟 90 秒，后台最迟 360 秒，期间仍显示在线 | 固定 |
| 每个用户同时在线的设备 | 与同时登录的设备数相同，见用户 | 运行策略 |
| 每个应用新建长连接的速度 | 每秒 1200 条 | 配额 |
| 每个应用的并发连接数 | 由套餐决定，默认套餐不限。达到后新的长连接被关闭，已经建立的连接不受影响 | 套餐 |
| 客户端：查询在线状态 | 每个用户每分钟 600 人 | 固定 |
| 客户端：订阅在线状态 | 每个用户每分钟 30 次 | 固定 |
回调
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个应用的回调地址 | 5 个 | 固定 |
| 地址的名称、URL | 1 到 64 个字符、1024 个字符 | 固定 |
| 每个地址订阅的事件 | 1 到 50 项 | 固定 |
| 事件回调的超时 | 5000 毫秒 | 每个地址设置（1000 到 10000 毫秒） |
| 每个地址的并发请求 | 10 个 | 每个地址设置（1 到 50） |
| 每个地址每秒的请求 | 100 个 | 每个地址设置（1 到 1000），不超过应用全部地址的合计 |
| 应用全部地址每秒的请求 | 500 个，超出的事件排队晚一些发出 | 配额 callback_qps_limit |
| 每批事件数 | 1 个；合并时一次请求的请求体不超过 1 MB | 每个地址设置（1 到 100） |
| 每个地址待投递的事件 | 50 万条，积满后新的事件被丢弃 | 联系我们 |
| 事件回调的重试 | 从排队起 24 小时内，最多发送 12 次 | 固定 |
每个事件的 data | 70 KB，超出时去掉其中的内容和列表类的字段 | 固定 |
| 同步回调的等待时间 | 1000 毫秒；还受消息的检查合计 3 秒、聊天室消息合计 500 毫秒的限制 | 每种同步回调设置（100 到 3000 毫秒） |
| 同步回调的响应 | 64 KB；拒绝的原因代码 1 到 64 个字符，提示最长 256 个字符 | 固定 |
| 同步回调的并发 | 每个服务实例对每个地址 200 个请求，超出的按失败处理 | 固定 |
| URL 验证和测试发送 | 每个应用每分钟合计 20 次 | 固定 |
| 投递记录 | 投递成功的保留 1 小时，投递失败的保留 7 天 | 固定 |
| 请求记录、统计 | 分别保留 7 天、90 天 | 固定 |
应用与凭据
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 每个控制台账号自己创建的租户 | 5 个 | 固定 |
| 每个租户的应用数（不含已删除的） | 10 个 | 企业认证通过后可以联系我们提高 |
| 每个租户的成员数（含待接受的邀请） | 20 人 | 企业认证通过后可以联系我们提高 |
app_name | 3 到 32 个字符，以小写字母开头，由小写字母、数字和 - 组成；创建后不能修改，删除后不能再次使用 | 固定 |
| 每个应用同时有效的 Client Secret | 2 个 | 固定 |
| 轮换 Secret 时旧 Secret 的宽限期 | 24 小时 | 轮换时设置（1 到 720 小时） |
| 每个应用的 IP 白名单 | 200 条 | 固定 |
| App Token 的有效期 | 7 天 | 运行策略 app_token_ttl_seconds（5 分钟到 1 年） |
| 换取 App Token | 每个来源 IP 每分钟 120 次 | 固定 |
| REST API 调用 | 每个应用每秒 1200 次，与换取 App Token 共用，批量接口按项数计算 | 配额 |
| 客户端接口调用 | 每个应用每秒 1200 次，与 REST API 分开计算 | 配额 |
请求格式与分页
| 项目 | 上限或默认值 | 调整方式 |
|---|---|---|
| 请求体 | 单个 JSON 对象，最大 1 MiB | 固定 |
请求头 X-Request-ID | 最长 64 个字符，由字母、数字和 -、_、. 组成 | 固定 |
| 列表每页 | 默认 20 条，最多 100 条；好友列表、黑名单和群成员列表默认 100 个，最多 500 个 | 固定 |
| 批量接口一次处理 | 100 项；批量发送消息的接收人数见消息与会话 | 固定 |
| 时间精度 | 毫秒 | 固定 |
独立 RTC 频道
这些限制与原通话分别定义，详见频道概述。
| 项目 | 当前范围 / 默认值 |
|---|---|
| channel_id | 1～64 个 ASCII 字符；首字符字母 / 数字，其余可含 _、-；区分大小写，关闭后不复用 |
| 名称 / ext | 名称最多 128 字符；ext 对象最多 4 KB |
| 同时参与人数 | 1～64，默认 16；预留及尚未清理的退出会话仍占位 |
| 应用开放频道数 | 默认 1000，由平台配置；与媒体并发额度不同 |
| 票据批量签发 / 撤销 | 一次 1～50 个不重复用户 |
| 票据有效期 | 30～300 秒，默认 120 秒；只能消费一次 |
| 加入期限 | 首次预留后 60 秒，准备 / 重试 / 确认不重新计时 |
| 心跳 / 超时 | 服务端建议 15 秒一次；45 秒无有效心跳开始退出；当前 SDK 约 10 秒一次 |
| 参与最长时长 / 媒体凭据 | 最长 12 小时；凭据通常 60 秒，不超过加入 / 会话期限 |
| 同用户媒体占用 | 原通话和独立频道共用，一个用户同时一个资源；多设备不能同时加入 |
| 应用媒体并发 | 原通话和活跃频道媒体代次共用套餐额度，不按频道人数扣减 |
| client_session_id / operation_id | 1～64 个可打印 ASCII 字符，不含空格；重试固定 |
| 管理说明 | 最多 256 字符；封禁说明必填 |
| 会话 / 用量保留 | 会话 90 天，用量统计最近 180 个统计日 |
| 单次统计范围 | 最多 92 天，不能查询未来 |
| 创建 / 新加入限流 | 每应用每分钟 60 次创建；每应用用户每分钟 10 次新加入 |
| 票据 / 查询限流 | 每应用每分钟 300 个签发用户；每应用用户每分钟 120 次普通客户端请求 |
| 心跳 / 续凭据限流 | 每会话每分钟 10 / 6 次；429 遵循 Retry-After |
频道的媒体回收可能持续重试，HTTP 202 不代表占用已释放。日用量状态和迟到更正见频道统计。