월 사용 한도
API 키별 한도와 구성원별 한도를 확인하고 변경하세요.
개인 키로 요청하면 API 키 한도와 구성원 한도가 함께 적용됩니다.
무엇을 제한할지 선택하기
AI 게이트웨이에는 API 키 월 한도와 구성원 월 한도가 있습니다. 개인 키로 요청하면 두 한도가 함께 적용됩니다.
| 구분 | API 키 월 한도 | 구성원 월 한도 |
|---|---|---|
| 제한하는 대상 | API 키 한 개 | 한 사람이 만든 모든 개인 키 |
| 알맞은 용도 | 업무, 자동화 또는 외부 도구 하나의 사용량 제한 | 구성원 한 사람의 전체 사용량 제한 |
| 사용량 계산 | 해당 키로 사용한 양 | 해당 구성원의 모든 개인 키로 사용한 양의 합계 |
| 새 키를 만들면 | 새 키에 별도 한도를 설정할 수 있음 | 새 키에도 같은 구성원 한도가 계속 적용됨 |
| 누가 관리하나 | 키를 만든 사람 또는 화면에 키가 보이는 스페이스 관리자(Admin) | Admin |
현재 스페이스의 API 키 관리 화면에는 키별 월 한도와 제한 없음 여부가 표시됩니다. 모델별 단가와 지원 범위는 현재 모델 단가와 지원 API 보기에서 확인합니다.
| API 키 월 한도 항목 | 현재 범위 |
|---|---|
| 적용 단위 | API 키 한 개 |
| 기간 | 월 |
| 입력 단위 | unit |
| 제한 방식 | 상한 도달 시 호출 차단 |
| 설정하지 않음 | 제한 없음 |
같은 키로 호출하는 지원 API에는 엔드포인트와 관계없이 같은 API 키 월 한도가 적용됩니다. 키 화면의 제한 없음은 해당 키의 월 한도만 적용하지 않는다는 뜻입니다. 구성원 월 한도, API 키 인증, 모델 접근 범위 및 보유 유닛에 따른 차단은 그대로 유지됩니다.
이번 달 사용량은 매월 1일 00:00 KST부터 새 달 기준으로 집계됩니다. 실시간 호출에서는 정책 검사에 따른 429 policy_limit_exceeded와 사용량 추적에 따른 429 usage_limit_exceeded가 모두 발생할 수 있습니다. Batch 신규 제출은 같은 정책 검사에서 키 또는 구성원 한도에 걸리면 429 policy_limit_exceeded를 반환합니다. 이 경우 한도와 사용량을 확인한 뒤 다시 제출하며, 새 요청 키로 우회하지 않습니다. 이미 접수한 작업의 처리와 비용은 Batch 비용 안내를 확인합니다.
API 키 월 한도 정하기
대상 키 확인하기
AI 게이트웨이 > API 키에서 현재 스페이스와 대상 키의 이름 및 소유자를 확인합니다. Member는
내 키, Admin은 필요에 따라내 키또는전체 키에서 찾습니다.수정 화면에서 한도 입력하기
대상 키의 수정 화면을 열고 월 한도를 unit 단위로 입력합니다. 제한을 두지 않으려면 입력란을 비워 둡니다.
저장 결과 확인하기
저장한 뒤 키 목록이나 상세 화면에 월 한도 또는 제한 없음 상태가 표시되는지 확인합니다. 차단된 호출을 다시 시작하기 전에는 최근 사용량과 새 한도가 의도한 값인지 함께 확인합니다.
구성원 월 한도 관리하기
Admin은 AI 게이트웨이 > 한도에서 구성원 전체의 사용량과 한도를 확인하고, 자신과 Member의 월 한도를 변경할 수 있습니다.
구성원 상태 확인하기
이름, 역할, 이번 달 사용량, 월 한도와 사용률을 확인합니다. 자신의 한도와 Member의 한도를 바꿀 수 있으며, 다른 Admin의 한도는 이 화면에서 바꿀 수 없습니다.
한 명 또는 여러 명 선택하기
한 명의 수정 버튼을 선택하거나 여러 Member를 선택합니다. 한 번에 바꿀 때는 선택한 구성원과 인원 수를 다시 확인합니다.
한도 저장하고 결과 확인하기
월 한도를 직접 입력하거나 제한 없음으로 바꾼 뒤 저장합니다. 이미 사용한 양과 같거나 낮은 한도를 저장하면 다음 호출이 중단될 수 있다는 경고가 표시됩니다. 저장 뒤 대상 구성원의 월 한도가 바뀌었는지 확인합니다.
새 구성원 기본 월 한도 정하기
새로 초대되는 구성원에게 같은 시작 한도를 적용하려면 AI 게이트웨이 > 한도 상단의 신규 구성원 기본 한도를 사용합니다.
현재 기본 한도 확인하기
화면 상단에서 현재 값을 확인하고 수정 버튼을 선택합니다. 새 스페이스에는 숫자형 기본 한도가 자동으로 설정되지 않으며, 스페이스를 만든 첫 Admin의 구성원 한도도 자동으로 생기지 않습니다.
제한 없음 또는 직접 지정 선택하기
구성원 월 한도를 두지 않으려면
제한 없음을 선택합니다. 값을 정하려면직접 지정을 선택하고 unit 단위로 입력합니다.0은 제한 없음이 아니라 월 한도를 0 unit으로 정한 값입니다.저장하고 적용 대상 확인하기
저장한 기본 한도는 이후 초대되는 구성원에게 적용됩니다. 이미 참여 중인 구성원의 한도는 바뀌지 않으므로 필요한 구성원은 목록에서 선택해 따로 변경합니다.
사용 목적과 호출 변동 폭을 함께 고려해 한도를 정합니다. 운영 환경에 연결한 뒤에는 누적 사용량을 분석에서 점검하고, 보유 및 초과 상태는 유닛에서 확인합니다.
| 시나리오 | 고려할 점 |
|---|---|
| 외부 AI 도구 | 반복 호출이 발생해도 감당할 수 있는 범위인지 확인합니다 |
| 사내 자동화와 봇 | 평소 업무량과 일시적인 호출 증가를 함께 고려합니다 |
| 일회성 실험 | 실험 기간과 만료일을 함께 검토합니다 |
한도를 설정할 수 있는 역할
| 작업 | Admin | Member |
|---|---|---|
| 자신의 API 키 한도 설정 및 변경 | 가능 | 가능 |
| 다른 사용자의 API 키 한도 설정 및 변경 | 가능 | 불가 |
| 자신의 구성원 한도 확인 | 가능 | API 키 화면에서 가능 |
| 자신의 구성원 한도 변경 | 가능 | 불가 |
| Member의 구성원 한도 확인 및 변경 | 가능 | 불가 |
| 다른 Admin의 구성원 한도 확인 | 가능 | 불가 |
| 다른 Admin의 구성원 한도 변경 | 한도 화면에서 불가 | 불가 |
| 새 구성원 기본 한도 확인 및 변경 | 가능 | 불가 |
Member는 내 키만 보고, API 키 화면에서 자신의 이번 달 사용량과 구성원 한도를 확인합니다. Admin은 전체 키에서 다른 사용자의 키를 관리하고, 한도 화면에서 조직의 구성원별 사용량과 한도를 관리합니다. Admin이 다른 구성원의 키를 관리해도 키를 만든 사람은 바뀌지 않습니다. 역할별 조회 및 관리 범위는 API 키와 구성원 권한에서 확인합니다.
한도에 도달했을 때
한도와 관련된 요청 실패가 발생하면 먼저 자신의 API 키 화면에서 이번 달 사용량과 구성원 한도를 확인하고, 대상 키의 월 한도도 함께 봅니다. Member는 구성원 한도를 직접 바꿀 수 없으므로 Admin에게 변경을 요청합니다. Admin은 한도 화면에서 해당 구성원의 사용량과 한도를 확인한 뒤 변경 여부를 판단합니다.
오류 응답에서는 HTTP 상태, type, detail, error_ref를 확인합니다. 한도를 올리거나 제한 없이 저장하기 전에 키의 사용처와 최근 사용량을 확인하고, 오류 유형별 대응 방법을 따릅니다.