멤버

AI Gateway에서 멤버 역할이 어떻게 나뉘는지, 그리고 사용량·키·한도를 어떻게 통제하는지 설명합니다. 멤버를 직접 추가하거나 제거하려면 Space 멤버 관리에서 합니다.

멤버 역할

AI Gateway에서 Admin과 Member는 할 수 있는 일이 다릅니다. 이 역할은 플랫폼 Space 역할을 그대로 상속하므로, Space에서 Admin이면 Gateway에서도 Admin입니다.

Gateway Admin 권한

Admin은 Space 전체의 키, 한도, 사용량을 관리합니다.

영역	권한
키	모든 키 조회(자기 키와 다른 멤버 키), 모든 키 비활성화·폐기
한도	Service·Member·Key 한도 정책 설정
사용량	Space 전체·멤버별·키별 사용량 조회, CSV 다운로드
카탈로그	카탈로그 조회
에셋	모든 엔드포인트 호출

Gateway Member 권한

Member는 자기 키와 사용량만 다룹니다. 다른 멤버의 키는 보지 못합니다.

영역	권한
키	자기 키 생성·수정·비활성화·폐기. 다른 멤버 키는 조회 불가
한도	자기 키의 Key Limit만 설정. Member·Service Limit는 Admin 영역
사용량	자기 키·자기 사용량만 조회
카탈로그	카탈로그 조회
에셋	모든 엔드포인트 호출

권한 매트릭스

이 표는 Gateway 안에서의 동작만 다룹니다. Space 수준의 더 일반적인 권한은 Space 멤버 역할 — 권한 매트릭스를 참고합니다.

동작	Admin	Member
자기 키 발급·수정·폐기	✓	✓
자기 키에 Key Limit 설정	✓	✓
다른 멤버 키 조회	✓	✗
다른 멤버 키 비활성화·폐기	✓	✗
다른 멤버 키 발급	✗	✗ (본인만 발급)
자기 사용량 조회	✓	✓
Space 전체·멤버별·키별 사용량 조회	✓	✗
Service Limit 설정	✓	✗
Member Limit 설정	✓	✗
카탈로그·요금 조회	✓	✓
모델 호출(chat·embeddings 등)	✓	✓

표에 표시한 차단은 UI와 API 양쪽에서 똑같이 적용됩니다.

멤버 관리

Admin은 Gateway에서 누가 얼마를 쓰는지 확인하고, 멤버별 키와 한도를 조정합니다. 특정 멤버의 사용량을 확인하거나 키와 한도를 바꿔야 할 때 이 절을 참고합니다.

시작 전 알아야 할 것

본인이 Gateway Admin이어야 합니다. 플랫폼 Admin은 자동으로 Gateway Admin이 됩니다.
멤버를 직접 추가하거나 제거하려면 Space 멤버 관리에서 합니다. 이 절은 Gateway 안에서의 운영을 다룹니다.
멤버는 자기 키와 사용량만 볼 수 있습니다. 모든 멤버를 보려면 Admin이어야 합니다.

멤버 목록 보기

좌측 메뉴에서 AI Gateway를 열고 멤버 탭으로 이동합니다. 다음 컬럼을 볼 수 있습니다.

컬럼	의미
이름	멤버 이름
역할	Gateway Admin / Gateway Member
이번 달 사용	이번 달 누적 사용액(USD 원가)
Member Limit	한도(설정한 경우)와 잔여 한도
키 개수	해당 멤버가 만든 키 수
마지막 호출	가장 최근에 호출한 시각

멤버별 사용 현황

멤버 목록에서 해당 행을 클릭하면 상세 화면이 열립니다. 한 멤버의 사용 현황을 자세히 볼 때 이 화면을 참고합니다.

항목	내용
기간별 사용량 그래프	일·주·월 단위 비용
키 목록	그 멤버가 만든 모든 키와 키별 이번 달 사용액
모델별 분포	가장 많이 쓰는 모델
Member Limit 대비 잔여	한도 대비 남은 금액(USD)

Space 전체나 모델별 관점은 사용량 분석에서 봅니다. 이 절은 멤버 단위로 다룹니다.

멤버 한도 조정

Member Limit는 멤버 단위로 설정하고 바꿉니다.

Member Limit 섹션 열기

멤버 상세 화면에서 Member Limit 섹션을 엽니다.

한도 값 입력하고 저장

USD 값을 입력하고 저장을 누릅니다.

적용 확인

다음 호출부터 새 한도가 즉시 적용됩니다.

자세한 내용은 Member Limit를 참고합니다.

멤버 단위 한도는 신뢰도와 작업 성격에 따라 다르게 둡니다. 외부 도구만 쓰는 멤버는 Space 기본값을 그대로 두고, 사내 자동화를 운영하는 멤버는 한도를 더 넓게 잡습니다.

멤버 키 통제

Admin은 다른 멤버의 키도 보고 비활성화하거나 폐기할 수 있습니다. 단, 키 발급은 본인만 할 수 있습니다.

작업	위치
다른 멤버 키 조회	AI Gateway의 키에서 모든 키 Admin 뷰 열기
다른 멤버 키 비활성화	AI Gateway의 키에서 해당 키를 열고 비활성화 선택
다른 멤버 키 폐기	AI Gateway의 키에서 해당 키를 열고 폐기 선택
키 발급은 본인만	Admin이라도 다른 멤버의 키는 만들 수 없습니다

자세한 내용은 키 라이프사이클을 참고합니다.

멤버가 떠날 때

플랫폼에서 Member를 제거하면 그 멤버의 모든 Gateway 키를 즉시 쓸 수 없게 됩니다.

시점	자동 동작
플랫폼 멤버 제거	해당 멤버의 모든 Gateway 키를 즉시 차단(`401`)
키 상태	사용할 수 없는 상태로 표시

자세한 절차는 Space 멤버 관리 — 멤버 제거를 참고합니다.

자주 만나는 오류

증상	원인·해결
멤버 탭이 보이지 않습니다	본인이 Gateway Admin이 아닐 때 나타납니다. 멤버 역할에서 권한을 확인합니다
한도를 바꿨는데 즉시 반영되지 않습니다	잠시 후 다시 확인합니다. 계속 그대로면 `customer.service@letsur.ai`로 문의합니다
멤버 키를 폐기한 뒤에도 한두 번 더 호출이 통합니다	잠시 후 다시 확인합니다. 계속 동작하면 `customer.service@letsur.ai`로 문의합니다
멤버가 키를 만들지 못한다고 합니다	Service Limit·Member Limit를 설정하지 않았는지 확인합니다. 한도를 설정하지 않으면 무제한이라 키 발급이 막히지 않으므로, 키 활성화 누락 같은 다른 원인을 확인합니다

멤버