팀별 API 키 관리
여러 API 키를 등록하고 대표 키 또는 특정 팀이 사용할 전용 키를 지정합니다.
사용 조건
관리자앱의 AI 연결BYOK AI팀별 키를 선택합니다. 구독 권한이 필요한 메뉴입니다. 팀 목록과 회사가 보유한 제공사 키를 먼저 준비하세요.
어떤 키가 쓰이는지
한 요청에 여러 키가 후보일 때는 아래 순서로 정해집니다.
| 우선순위 | 키 | 적용 대상 |
|---|---|---|
| 1 | 사용자 전용 키 | 시스템에 사용자 전용 키가 따로 있으면 가장 먼저 사용합니다. |
| 2 | 팀 전용 키 | 팀에 전용 키를 지정했다면 그 팀의 요청에 사용합니다. |
| 3 | 대표 API 키 | 위 두 가지가 없을 때 제공사별 대표 키를 사용합니다. |
키 등록과 확인
- 1 키 등록을 선택하고 제공사, 알아보기 쉬운 키 이름과 API 키를 입력합니다.
- 2 같은 제공사의 첫 활성 키는 대표 키로 자동 지정될 수 있습니다.
- 3 등록한 키를 선택해 연결 테스트를 실행하고 상태와 확인 시각을 확인합니다.
- 4 제공사별 대표 키를 바꾸려면 대표 API 키 설정에서 활성 키를 선택해 저장합니다.
팀 전용 키 지정하기
- 1 왼쪽에서 사용할 키를 선택합니다.
- 2 팀 목록에서 이 키를 사용할 팀을 찾습니다.
- 3 해당 팀에 키를 지정하고 저장 결과를 확인합니다.
- 4 팀 전용 설정을 해제하면 대표 키 사용 정책으로 돌아가는지 확인합니다.
상태 변경과 삭제
- 1 대표 키 다른 활성 키를 대표로 바꾸기 전에는 비활성화할 수 없습니다.
- 2 비활성 키 기록은 보존하지만 새 요청에 사용하지 않습니다.
- 3 삭제 연결된 팀과 사용 중인 모델에 영향이 있으므로 대체 키를 먼저 지정합니다.
- 4 연결 경고 키 권한 만료, 제공사 장애 또는 네트워크 문제를 확인하고 다시 테스트합니다.
팀 전용 키는 제공사 비용을 분리하기 위한 운영 설정입니다. 키를 바꾸기 전 해당 팀의 진행 중인 업무와 제공사 한도를 확인하세요.
자주 묻는 질문
대표 키와 팀 전용 키가 모두 있으면 무엇을 쓰나요?
팀에 전용 키를 지정했다면 팀 전용 키를 씁니다. 팀 전용 키가 없으면 대표 키를 씁니다. 시스템에 사용자 전용 키가 따로 있으면 그 키가 가장 먼저 사용됩니다.
대표 키를 바로 비활성화할 수 없습니다.
대표 키가 비면 그 제공사 요청을 처리할 키가 없어지기 때문입니다. 다른 활성 키를 대표로 먼저 바꾼 뒤 기존 키를 비활성화하세요.