키

Gateway 키는 모든 API 호출의 인증 단위입니다. 키 하나에 “누가 얼마까지 쓸 수 있는지”가 담깁니다. 키마다 한도·만료·소유자를 지정하며, Admin과 Member 모두 본인 명의의 키를 발급할 수 있습니다.

시작 전 알아야 할 것

이 문서에서 키를 만들고 운영하고 폐기하는 방법을 한곳에서 다룹니다. 첫 키를 발급하거나, 키를 만료·폐기하거나, 멤버 변경에 맞춰 키를 고칠 때 이 문서를 참고합니다.

누가 만드나 — Admin과 Member 모두 자기 키를 만듭니다(Gateway 멤버 역할).
누가 보나 — Admin은 모든 키를 보고, Member는 자기 키만 봅니다.
한도 단위 — 키 한도는 USD 원가를 기준으로 합니다. 자세한 내용은 한도 개요를 참고합니다.
키 값 노출 — 키 값은 발급 직후 한 번만 보이며, 화면을 떠나면 다시 볼 수 없습니다.

키 만들기

키 탭 열기

왼쪽 메뉴에서 AI Gateway를 열고 키 탭으로 이동한 뒤 새 키 버튼을 누릅니다.

이름 정하기

어디에 쓰는 키인지 알 수 있는 이름으로 짓습니다(예: cursor-prod, claude-code-personal, internal-bot-v1). 키가 많아져도 이름만 보고 용도를 알 수 있습니다.

만료일·한도 정하기 (선택)

만료일 — 무기한 또는 특정 날짜 중에서 고릅니다. 외부 도구나 일회성 실험에는 만료일을 정하기를 권장합니다.
한도 — Key Limit를 USD/월 단위로 정합니다. 정하지 않으면 Member·Service 한도까지만 막힙니다. 자세한 내용은 Key 한도에서 확인합니다.

사용량 기준 확인하기

현재는 멤버 기준으로 사용량이 합산됩니다.

발급하고 바로 저장하기

발급 버튼을 누르면 키 값(sk_...)이 한 번 표시됩니다. 곧바로 환경변수나 시크릿 매니저에 저장합니다.

키 값을 코드·채팅·메일 본문에 그대로 붙이지 않습니다. 노출되면 즉시 폐기하고 재발급합니다.

키 목록 보기

왼쪽 메뉴에서 AI Gateway를 열고 키 탭으로 이동합니다. 표시되는 컬럼은 다음과 같습니다.

컬럼	의미
이름	발급 시 입력한 이름
상태	Active / Inactive / Expired / Limited / Revoked
만료	무기한 또는 만료 날짜
이번 달 사용	USD 원가 기준 누적
한도	Key Limit(있을 때)
마지막 사용	마지막 호출 시각

Member — 본인이 만든 키만 봅니다.
Admin — Space 안의 모든 멤버 키를 보며, 멤버 컬럼이 추가로 표시됩니다.

검색, 정렬, 상태 필터를 씁니다.

키 수정

키 목록에서 해당 키 행의 수정 버튼을 누르고 값을 바꿔 저장하면, 다음 호출부터 새 설정이 곧바로 적용됩니다.

변경 가능	변경 불가
이름, 만료일, 한도	키 값 자체(재발급만 가능), 소유자

키 비활성화와 폐기

키를 멈추는 방법은 두 가지입니다. 잠시 멈출지, 영구히 끊을지에 따라 고릅니다. 키 값이 유출됐다면 즉시 폐기하고 새 키를 발급합니다.

상황	절차	되돌릴 수 있나
잠시 멈춤	비활성화 토글 OFF	가능(재활성)
영구 차단	폐기 버튼	불가(새 키 발급)
키 값 유출	즉시 폐기 후 새 키 발급, 사용처 갱신	—

비활성화하면 이렇게 동작합니다.

호출은 거부됩니다(401).
사용량 데이터는 보존됩니다.
토글을 다시 ON으로 돌리면 곧바로 다시 쓸 수 있습니다.

폐기하면 이렇게 동작합니다.

호출은 거부됩니다(401).
같은 키 값은 다시 살릴 수 없습니다.
사용량 데이터는 보존됩니다.

폐기는 되돌릴 수 없습니다. 잠시만 막고 싶다면 폐기가 아니라 비활성화를 씁니다.

자동으로 막히는 경우

다음 이벤트가 일어나면 사용자가 손대지 않아도 키가 자동으로 막힙니다.

이벤트	결과
만료일 도달	자동으로 만료됩니다. 호출이 거부되며(`401`), 만료일을 바꾸거나 재발급해 복구합니다
한도 초과(Key·Member·Service)	자동으로 차단됩니다. 다음 리셋(월 한도)이나 한도 상향 전까지 거부됩니다(`429`)
키 소유자가 Space에서 제거됨	즉시 쓸 수 없습니다. 멤버를 다시 초대해도 키는 살아나지 않으므로 새 키를 발급합니다
Space의 AI Gateway 비활성화	활성 키를 쓸 수 없게 됩니다. 키 객체와 사용량 데이터는 보존되며, 다시 활성화하면 복원됩니다
멤버 역할 변경(Member ↔ Admin)	키는 그대로 유지되고, 권한 매트릭스가 곧바로 반영됩니다

자주 만나는 오류

증상	원인과 해결
`401 Unauthorized`	키가 잘못됐거나 폐기·만료된 경우입니다. 키 목록에서 상태를 확인합니다
`429` 한도 초과	Key·Member·Service 한도 중 하나에 걸린 경우입니다. 어느 한도인지는 응답 본문에서 확인합니다. 자세한 내용은 한도 개요를 참고합니다
키 발급 직후 호출이 안 됨	몇 초 뒤 다시 시도합니다
멤버가 Space에서 제거된 뒤 키가 살아 있음	잠시 후 다시 확인합니다. 계속 동작하면 `customer.service@letsur.ai` 로 문의합니다
만료된 키를 다시 살리고 싶음	만료일을 바꿔 복구합니다. 단, 폐기된 키는 다시 활성화할 수 없습니다

자주 묻는 질문

Q. Admin이 다른 멤버의 키를 직접 만들 수 있나요?

키 발급은 본인만 합니다. Admin은 다른 멤버의 키를 조회·폐기·비활성화하지만 발급하지는 않습니다. 본인 동의 없이 키가 만들어지지 않도록 막는 장치입니다.

Q. 같은 멤버가 키를 여러 개 만들 수 있나요?

만들 수 있습니다. 도구별·환경별로 키를 분리하기를 권장합니다. 한 키가 막혀도 다른 도구는 그대로 동작하고, 키마다 한도를 다르게 정할 수 있습니다(예: 외부 도구 키는 좁게, 사내 자동화는 넓게).

Q. 키 값을 잊어버렸는데 다시 볼 수 있나요?

다시 볼 수 없습니다. 새 키를 발급하고 사용처(외부 도구·코드·환경변수)를 바꾼 뒤 옛 키를 폐기합니다.

키