API 키 월 한도
키 소유자와 Admin이 월 한도를 unit 단위로 설정하세요.
월 한도는 API 키마다 unit 단위로 적용되며, 한도에 도달하면 호출이 차단됩니다.
한도가 적용되는 단위
월 한도는 API 키 한 개에 설정하는 월 사용 상한입니다. 키를 만들 때 입력하거나 기존 키의 수정 화면에서 변경할 수 있습니다.
현재 스페이스의 API 키 관리 화면에는 키별 월 한도와 제한 없음 여부가 표시됩니다. 모델별 단가와 지원 범위는 현재 모델 단가와 지원 API 보기에서 확인합니다.
| 항목 | 현재 범위 |
|---|---|
| 적용 단위 | API 키 한 개 |
| 기간 | 월 |
| 입력 단위 | unit |
| 제한 방식 | 상한 도달 시 호출 차단 |
| 설정하지 않음 | 제한 없음 |
같은 키로 호출하는 지원 API에는 엔드포인트와 관계없이 같은 월 한도가 적용됩니다. 제한 없음은 이 월 한도만 적용하지 않는다는 뜻이며, API 키 인증, 모델 접근 범위 및 보유 유닛에 따른 차단은 그대로 유지됩니다.
월 한도에 도달해 요청이 차단되면 429 usage_limit_exceeded가 반환됩니다. 특정 리셋 시각은 추정하지 말고 현재 키 화면과 오류 응답을 확인합니다.
월 한도 정하기
대상 키 확인하기
AI 게이트웨이 > API 키에서 현재 스페이스와 대상 키의 이름 및 소유자를 확인합니다. Member는
내 키, Admin은 필요에 따라내 키또는전체 키에서 찾습니다.수정 화면에서 한도 입력하기
대상 키의 수정 화면을 열고 월 한도를 unit 단위로 입력합니다. 제한을 두지 않으려면 입력란을 비워 둡니다.
저장 결과 확인하기
저장한 뒤 키 목록이나 상세 화면에 월 한도 또는 제한 없음 상태가 표시되는지 확인합니다. 차단된 호출을 다시 시작하기 전에는 최근 사용량과 새 한도가 의도한 값인지 함께 확인합니다.
사용 목적과 호출 변동 폭을 함께 고려해 한도를 정합니다. 운영 환경에 연결한 뒤에는 누적 사용량을 분석에서 점검하고, 보유 및 초과 상태는 유닛에서 확인합니다.
| 시나리오 | 고려할 점 |
|---|---|
| 외부 AI 도구 | 반복 호출이 발생해도 감당할 수 있는 범위인지 확인합니다 |
| 사내 자동화와 봇 | 평소 업무량과 일시적인 호출 증가를 함께 고려합니다 |
| 일회성 실험 | 실험 기간과 만료일을 함께 검토합니다 |
한도를 설정할 수 있는 역할
| 대상 키 | Admin | Member |
|---|---|---|
| 자신이 소유한 키 | 설정 및 변경 가능 | 설정 및 변경 가능 |
| 다른 사용자가 소유한 키 | 설정 및 변경 가능 | 조회 및 변경 불가 |
Member는 내 키만 보고, Admin은 전체 키에서 다른 사용자의 키도 확인할 수 있습니다. 역할별 조회 및 관리 범위는 API 키에서 확인합니다.
한도에 도달했을 때
한도와 관련된 요청 실패가 발생하면 응답의 HTTP 상태, type, detail, error_ref를 확인합니다. 한도를 올리거나 제한 없이 저장하기 전에 키의 사용처와 최근 사용량을 확인하고, 에러 유형별 대응 방법을 따릅니다.