한도 및 액세스

콘솔 설정 → 한도 및 액세스(Settings → Limits & access) 에서 팀 전체의 예산과 액세스 규칙을 한곳에서 관리합니다. 예상치 못한 과다 지출을 막고, API Key가 유출되었을 때 악용되는 것도 방지할 수 있습니다.

예산 한도

예산은 팀, 멤버, API Key의 세 단계로 나뉘며, 주기는 일별, 월별, 총액 중에서 선택합니다.

• 팀 예산: 팀 전체의 지출 한도
• 멤버 기본 예산: 멤버마다 따로 계산합니다. 특정 멤버에게 예산을 따로 설정했다면 그 설정이 우선합니다
• Key 예산: API Keys 페이지에서 Key별로 설정

세 단계는 각각 따로 계산되며, 어느 한 단계라도 소진되면 요청이 차단됩니다. 같은 주기 안에서 Key 예산은 해당 멤버의 예산을, 멤버 예산은 팀 예산을 넘을 수 없습니다.

예산마다 처리 방식을 선택할 수 있습니다:

IP 허용 목록

지정한 IPv4 주소나 CIDR 대역에서만 호출을 허용하며, 최대 100개까지 등록할 수 있습니다. 목록에 없는 곳에서 보낸 요청은 거부됩니다.

• 팀 IP 허용 목록: 팀의 모든 API Key에 적용
• Key IP 허용 목록: 팀 목록을 바탕으로 개별 Key를 더 좁힙니다. Key 목록의 주소도 팀 목록에 포함되어 있어야 적용됩니다

프로덕션 Key를 자사 서버에만 묶어 두기에 적합합니다. Key가 유출되더라도 다른 곳에서는 호출할 수 없습니다.

사용 가능 모델

팀은 세 가지 방식 중 하나를 선택할 수 있으며, 공급자 단위로 한꺼번에 선택할 수도 있습니다:

개별 Key도 Key 메뉴의 「사용 가능 모델」에서 더 좁힐 수 있습니다. 팀과 Key의 규칙은 동시에 적용되며, 양쪽에서 모두 허용한 모델만 호출할 수 있습니다.

적용 규칙 확인

하나의 Key에는 팀과 Key 두 단계의 규칙이 함께 적용됩니다. API Keys 의 Key 메뉴에서 적용 규칙 확인(Check effective rules) 을 클릭하고 모델을 고르면, 그 호출이 차단되는지, 어떤 규칙에 차단되는지, 예산이 얼마나 남았는지 확인할 수 있습니다. 확인에는 크레딧이 들지 않습니다.

차단될 때의 응답

예산이나 액세스 규칙에 막힌 요청은 재시도해도 성공하지 않으므로 먼저 규칙을 조정해야 합니다:

차단된 요청은 활동(Activity) 의 「차단됨(Blocked)」 필터에 표시됩니다. 전체 오류 코드는 오류 처리를 참고하세요.

변경 기록

IP 허용 목록, 사용 가능 모델, 예산을 누가 언제 어떻게 바꿨는지는 한도 및 액세스 오른쪽 위의 변경 기록 에서 살펴볼 수 있습니다. 로그 보존 설정은 여기에 기록되지 않습니다. 요청 로그를 참고하세요.