API 키 관리
조직 구성원이 발급한 API 키를 관리자가 한 화면에서 모아 봅니다. 누가 키를 갖고 있는지, 그 키로 얼마나 호출했고 크레딧을 얼마나 썼는지 확인하는 조회 전용 화면입니다.
개요
| 항목 | 동작 |
|---|---|
| 진입 위치 | 관리자 → 데이터 → API 키 관리 |
| 열람 권한 | 전체 관리자. 그룹 관리자는 접근할 수 없습니다 |
| 노출 조건 | 게이트웨이 API를 사용하는 조직에만 메뉴가 보입니다 |
| 조회 범위 | 조직에서 발급된 모든 API 키 |
| 기간 | 상단 날짜 범위 선택기. 기본값은 지난달 1일부터 오늘까지 |
| 화면 구성 | 요약 카드 3개 · 발급된 키 목록 · 키 상세 |
이 화면에서는 키를 발급하거나 삭제할 수 없습니다. 발급·수정·삭제는 각 구성원이 자신의 개발자 화면에서 직접 합니다 — API로 챗봇 호출을 참고하세요.
활용하기
요약 카드
날짜 범위에 해당하는 값이 카드 세 개로 표시됩니다.
| 카드 | 의미 |
|---|---|
| 키를 보유한 멤버 | 선택한 기간에 키를 가지고 있는 구성원 수 |
| 호출 수 | 조직 전체 API 호출 건수 |
| 사용 크레딧 | 그 호출로 차감된 크레딧 |
발급된 키 목록
| 열 | 내용 |
|---|---|
| API 키 | 키 이름과 마스킹된 키 값. 이름을 누르면 상세로 이동합니다 |
| 소유자 | 키를 발급한 구성원. 사용이 중지된 계정이면 비활성 멤버 배지가 함께 표시됩니다 |
| 소속 그룹 | 소유자가 속한 멤버 그룹 |
| 발급일 | 키를 만든 날짜 |
| 최근 사용 | 마지막 호출 시각. 기간 내 호출이 없으면 이 기간 사용 없음 |
| 호출 수 | 선택한 기간의 호출 건수 |
| 크레딧 | 선택한 기간에 그 키가 쓴 크레딧 |
이름·발급일·최근 사용·호출 수·크레딧으로 정렬할 수 있고, 처음에는 크레딧이 많은 순으로 정렬됩니다. 키 이름이나 소유자 이름·이메일로 검색하고, 소속 그룹으로 범위를 좁힐 수 있습니다.
목록에는 키의 활성·비활성 상태를 구분하는 열이나 필터가 없습니다. 상태는 키 상세 화면 상단의 배지에서 확인합니다.
키 상세
목록에서 행을 누르면 키 하나의 상세 화면이 열립니다.
- 상단에 마스킹된 키 값, 소유자, 발급일, 최근 사용과 함께 활성·비활성 상태 배지가 표시됩니다.
- 그 아래 사용량 카드가 같은 날짜 범위 기준으로 호출 수와 크레딧을 보여줍니다.
- 호출 내역 표에는 시각·모델·챗봇·크레딧이 호출 단위로 쌓입니다. 어떤 키가 어떤 모델을 쓰고 있는지 확인할 때 사용합니다.
날짜 범위는 목록과 상세가 함께 씁니다. 기간을 바꾸면 카드·목록·호출 내역이 모두 같은 기간으로 갱신됩니다.
조직에서 API 사용 시작하기
게이트웨이 API 사용 여부는 조직 단위로 열립니다. 관리자 화면에는 이를 켜고 끄는 스위치가 없으므로, 아직 사용하고 있지 않다면 마인드로직 담당자에게 요청해 주세요. 사용이 열리면 관리자 메뉴에 API 키 관리가 나타나고, 구성원은 개발자 화면에서 각자 키를 발급할 수 있습니다.
발급 직후 한 번만 보이는 원본 키를 제외하면, 이 화면을 포함해 어디에서도 키 원문은 다시 표시되지 않습니다. 구성원이 키를 분실하면 새로 발급해야 합니다.
마지막 수정 날짜: Aug 28, 2026