대표 키·모델 관리
AI 제공사별 대표 API 키를 안전하게 등록하고 대화에 사용할 모델을 선택합니다.
시작하기 전에
관리자앱의 AI 연결BYOK AI키·모델 관리를 선택합니다. 회사가 계약한 AI 제공사의 API 키와 해당 계정의 과금 정책을 준비하세요. 대표 키와 모델 관리는 무료로 열리지만 실제 AI 사용 비용은 각 제공사 계정에 청구됩니다.
화면과 사용 기록에서 Direct로 표시되는 항목이 BYOK AI로 처리된 요청입니다.
API 키 원문은 저장 후 다시 표시되지 않습니다. 키를 문서나 메신저에 복사해 보관하지 말고 제공사에서 재발급할 수 있는 절차를 준비하세요.
전체 설정 순서
- 이 화면에서 제공사별 대표 API 키를 등록합니다
- 모델 목록을 갱신해 사용자앱에 보일 모델만 저장합니다
- 팀마다 다른 키를 써야 하면 ‘팀별 키’에서 전용 키를 지정합니다
- ‘사용 한도’에서 예산을 정하고 ‘사용 기록’에서 실제 사용을 확인합니다
대표 API 키 등록하기
- 1 제공사 행에서 키 등록을 선택합니다.
- 2 API 키를 입력하고 저장을 누릅니다.
- 3 연결 검증이 성공하면 마스킹된 힌트와 상태를 확인합니다.
- 4 기존 키를 바꾸려면 키 교체를 사용합니다. 새 키가 유효할 때만 기존 대표 키가 교체됩니다.
검증에 성공한 키의 뒷자리 힌트와 확인 시각이 표시되면 정상입니다.
사용할 모델 저장하기
- 1 대표 키가 있는 제공사에서 갱신으로 모델 목록을 다시 불러옵니다.
- 2 대화에 허용할 모델을 하나 이상 선택합니다.
- 3 저장을 누르고 변경사항 없음 안내로 바뀌는지 확인합니다.
- 4 사용자앱에서 BYOK 모델 목록이 의도대로 표시되는지 확인합니다.
대표 키를 교체하면 같은 제공사의 기존 활성 키와 팀 배정이 정리됩니다. 팀 전용 키를 쓰고 있었다면 교체 후 팀별 키를 다시 확인하세요.
삭제와 실패 처리
- 1 키 없음 대표 키를 등록해야 모델 목록을 조회할 수 있습니다.
- 2 검증 실패 제공사, 키 권한과 네트워크를 확인합니다. 실패한 새 키는 저장되지 않고 기존 키와 배정은 그대로 유지됩니다.
- 3 대표 키 삭제 해당 제공사의 선택 모델도 설정에서 제외됩니다.
- 4 모델을 선택하지 않음 BYOK 모델 설정을 저장할 수 없습니다. 사용할 모델을 한 개 이상 선택합니다.
자주 묻는 질문
BYOK 비용은 어디에서 청구되나요?
각 AI 제공사에서 청구됩니다. 예를 들어 OpenAI 키를 등록하면 OpenAI 계정의 API 사용량으로 계산됩니다. Dotory Chat은 그 키를 구성원이 함께 쓰도록 연결하고 사용 내역을 기록합니다.
저장한 API 키 전체 값을 다시 볼 수 있나요?
볼 수 없습니다. 저장 후에는 키 원문을 다시 보여주지 않으며, 화면에는 키 이름과 뒷자리 힌트만 표시됩니다.
대표 키 교체가 실패하면 기존 키도 바뀌나요?
바뀌지 않습니다. 새 키 검증이 성공해야 저장되며, 실패하면 기존 키와 기존 배정이 그대로 유지됩니다.