본문으로 건너뛰기

할당량 및 제한

각 플랜별 할당량을 정리합니다. 수치는 seed_plans.go 와 일치합니다.

핵심 카운터

함수 호출

플랜호출/월
Free10,000
Starter50,000
Pro100,000
Business1,000,000

DB 쿼리

플랜쿼리/월
Free100,000
Starter500,000
Pro1,000,000
Business10,000,000

DB / 파일 / 비디오 스토리지

플랜DB파일비디오
Free1GB1GB1GB
Starter5GB10GB10GB
Pro10GB20GB50GB
Business50GB100GB500GB

트래픽 (Egress)

플랜송신/월
Free10GB
Starter50GB
Pro100GB
Business500GB

WebSocket / WebRTC

플랜WebSocketWebRTC
Free100시간100분
Starter1,000시간1,000분
Pro10,000시간10,000분
Business100,000시간100,000분

푸시 알림

플랜발송/월
Free10,000
Starter100,000
Pro1,000,000
Business10,000,000

AI 스트림 토큰

플랜토큰/월
Free100,000
Starter1,000,000
Pro10,000,000
Business100,000,000

큐 / 워크플로우 / 채팅

플랜큐 메시지/월워크플로우 실행/월채팅 메시지/월
Free10,000501,000
Starter100,00050010,000
Pro1,000,0005,000100,000
Business10,000,00050,0001,000,000

동시 연결 / 앱 / 멤버

플랜동시 연결최대 앱앱당 멤버
Free5550
Starter2020500
Pro1001005,000
Business5001,00050,000

할당량 확인

📌 할당량 사용 현황은 콘솔 → 빌링 → 사용량 에서 확인하세요. SDK 에는 할당량 조회 메서드가 없습니다.

할당량 초과 처리

플랜 한도를 초과하면 402 Payment Required 응답이 반환됩니다(Free 플랜 또는 사용량 기반 과금 미설정 시. 유료 플랜에서 사용량 기반 과금을 켜면 예산 상한까지 차단 없이 종량 과금됩니다).

typescript
import { ApiError } from 'connectbase-client'

try {
    await cb.database.getData('tbl_users')
} catch (e) {
    if (e instanceof ApiError && e.statusCode === 402) {
        console.warn('할당량 초과 — 플랜 업그레이드 또는 사용량 기반 과금 설정이 필요합니다')
        showUpgradePrompt()
    }
}

할당량 알림 / 증가 요청

📌 할당량 알림 설정과 증가 요청은 콘솔에서 수행합니다:

  • 콘솔 → 빌링 → 알림: 한도의 80%/100% 도달 시 이메일/슬랙 알림
  • 콘솔 → 빌링 → 한도 증가 요청 또는 contact: 일시적/영구적 한도 증가 요청

Unlimited 플랜은 어드민 협의를 통해 한도를 조정할 수 있습니다.