할당량 및 제한
각 플랜별 할당량을 정리합니다. 수치는 seed_plans.go 와 일치합니다.
핵심 카운터
함수 호출
| 플랜 | 호출/월 |
|---|---|
| Free | 10,000 |
| Starter | 50,000 |
| Pro | 100,000 |
| Business | 1,000,000 |
DB 쿼리
| 플랜 | 쿼리/월 |
|---|---|
| Free | 100,000 |
| Starter | 500,000 |
| Pro | 1,000,000 |
| Business | 10,000,000 |
DB / 파일 / 비디오 스토리지
| 플랜 | DB | 파일 | 비디오 |
|---|---|---|---|
| Free | 1GB | 1GB | 1GB |
| Starter | 5GB | 10GB | 10GB |
| Pro | 10GB | 20GB | 50GB |
| Business | 50GB | 100GB | 500GB |
트래픽 (Egress)
| 플랜 | 송신/월 |
|---|---|
| Free | 10GB |
| Starter | 50GB |
| Pro | 100GB |
| Business | 500GB |
WebSocket / WebRTC
| 플랜 | WebSocket | WebRTC |
|---|---|---|
| Free | 100시간 | 100분 |
| Starter | 1,000시간 | 1,000분 |
| Pro | 10,000시간 | 10,000분 |
| Business | 100,000시간 | 100,000분 |
푸시 알림
| 플랜 | 발송/월 |
|---|---|
| Free | 10,000 |
| Starter | 100,000 |
| Pro | 1,000,000 |
| Business | 10,000,000 |
AI 스트림 토큰
| 플랜 | 토큰/월 |
|---|---|
| Free | 100,000 |
| Starter | 1,000,000 |
| Pro | 10,000,000 |
| Business | 100,000,000 |
큐 / 워크플로우 / 채팅
| 플랜 | 큐 메시지/월 | 워크플로우 실행/월 | 채팅 메시지/월 |
|---|---|---|---|
| Free | 10,000 | 50 | 1,000 |
| Starter | 100,000 | 500 | 10,000 |
| Pro | 1,000,000 | 5,000 | 100,000 |
| Business | 10,000,000 | 50,000 | 1,000,000 |
동시 연결 / 앱 / 멤버
| 플랜 | 동시 연결 | 최대 앱 | 앱당 멤버 |
|---|---|---|---|
| Free | 5 | 5 | 50 |
| Starter | 20 | 20 | 500 |
| Pro | 100 | 100 | 5,000 |
| Business | 500 | 1,000 | 50,000 |
할당량 확인
📌 할당량 사용 현황은 콘솔 → 빌링 → 사용량 에서 확인하세요. SDK 에는 할당량 조회 메서드가 없습니다.
할당량 초과 처리
플랜 한도를 초과하면 429 Too Many Requests 응답이 반환됩니다(현재 모든 플랜 overage_enabled = false, 추가 과금 없음).
typescript
import { ApiError } from 'connectbase-client'
try {
await cb.database.getData('tbl_users')
} catch (e) {
if (e instanceof ApiError && e.statusCode === 429) {
console.warn('할당량 초과 — 잠시 후 재시도하거나 플랜을 업그레이드하세요')
showUpgradePrompt()
}
}backoff 패턴은 흔한 에러 & 해결책 #3 을 참고하세요.
할당량 알림 / 증가 요청
📌 할당량 알림 설정과 증가 요청은 콘솔에서 수행합니다:
- 콘솔 → 빌링 → 알림: 한도의 80%/100% 도달 시 이메일/슬랙 알림
- 콘솔 → 빌링 → 한도 증가 요청 또는 contact: 일시적/영구적 한도 증가 요청
Unlimited 플랜은 어드민 협의를 통해 한도를 조정할 수 있습니다.