한도 설정
월별 사용량 한도 설정, 초과 시 동작, 알림 기준을 설명합니다.
한도 설정
예기치 않은 크레딧 소모를 방지하기 위해 Project별로 월별 사용량 한도(Monthly Limit)를 설정할 수 있습니다.
월별 한도란
월별 한도는 한 Project에서 한 달 동안 소비할 수 있는 크레딧의 최대값입니다. 설정된 한도에 도달하면 해당 Project의 API 요청이 제한됩니다.
- 최대 설정 가능 한도: 1,000 Credits/월
- 기본값: 설정하지 않으면 한도 없음
한도 설정 방법
- Project → 설정 → 사용량 및 과금 메뉴로 이동합니다.
- 월별 한도 항목에서 원하는 크레딧 값을 입력합니다.
- 저장을 클릭합니다.
[이미지 영역] 월별 한도 설정 화면
권한: 한도 설정은 Workspace의 Owner 또는 Admin 역할만 변경할 수 있습니다.
한도 초과 시 동작
한도에 도달하면 다음과 같이 동작합니다.
| 기능 | 동작 |
|---|---|
| REST API (읽기) | 한도 초과 시 429 Too Many Requests 반환 |
| REST API (쓰기) | 한도 초과 시 429 Too Many Requests 반환 |
| Webhook 발송 | 중단됩니다 |
| AI 기능 | 중단됩니다 |
| 파일 업로드 | 중단됩니다 |
| 대시보드 조회 | 영향 없음 |
한도 초기화 시점
월별 한도는 **매월 1일 00:00 (UTC 기준)**에 초기화됩니다. 이전 달에 소비한 크레딧은 당월 한도에 영향을 주지 않습니다.
경고 알림
한도의 특정 비율에 도달하면 알림을 발송합니다.
| 알림 시점 | 기본값 |
|---|---|
| 한도의 80% 소비 | 이메일 알림 발송 |
| 한도의 100% 소비 | 이메일 알림 발송 + API 제한 시작 |
알림 수신자와 임계값은 설정 화면에서 변경할 수 있습니다.
변경 이력
한도 설정 변경 이력은 Workspace 감사 로그에서 확인할 수 있습니다. 누가, 언제, 어떤 값으로 변경했는지 기록됩니다.