使用限制
本頁按功能列出數量上限、長度限制、頻率限制和預設值，供選型和設計時查閱。用瀏覽器的頁內搜尋（如搜“群”“撤回”“每分鐘”）最快。
表中“調整方式”一列的含義：
- 執行策略：租戶或應用可以在控制檯的執行策略中修改，括號中為可設定的範圍；
- 配額：平臺為每個應用設定的保護性上限，需要提高時請聯絡我們，見限流與應用狀態；
- 套餐：由應用的套餐決定，在控制檯應用詳情的“套餐與用量”中檢視，需要提高時請聯絡我們更換套餐，見套餐與賬單；
- 固定：不能調整。
說明：
- “個字元”按 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 小時內不能再被邀請進同一群。服務端新增成員不受限制 | 應用策略 group_invite_cooldown_enabled |
| 入群連結的有效期 | 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 秒） |
| 群通話同時在通話中的人數（含發起人） | 由套餐決定，預設不限 | 套餐的群通話人數上限；執行策略 max_group_call_participants（預設 0 不限）可以再收緊 |
| 發起群通話、在群通話中邀請時一次邀請的人數 | 人數上限減一；一次請求最多 1000 人，可以分多次邀請 | 固定 |
| 每個群通話累計涉及的成員（含已離開、拒絕、未接聽的） | 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 年或永久 | 固定 |
| 每個欄位檢查的內容 | 前 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 不代表佔用已經釋放。每日用量的狀態和遲到的更正見頻道統計。