AI Provider Key 설정
계정 프로젝트용 계정 키와 로컬 프로젝트용 로컬 키를 등록하고 관리합니다.
계정 키와 로컬 키
두 키 그룹은 저장 위치와 사용 프로젝트가 다르며 서로 대체되지 않습니다.
| 구분 | 계정 키 | 로컬 키 |
|---|---|---|
| 사용 범위 | 계정 프로젝트 | 로컬 프로젝트 |
| 저장 | 계정에 암호화 저장 | OS 보안 저장소 |
| 기기 범위 | 로그인한 환경에서 사용 | 현재 기기 전용 |
참고: 로그인한 Desktop에서는 두 그룹을 함께 관리하지만, 실제 요청에 사용할 소스는 현재 프로젝트 유형이 결정합니다. Web은 계정 키만, 비로그인 Desktop은 로컬 키만 사용합니다.
지원 Provider
Provider별 기본 또는 사용자 지정 Endpoint를 사용할 수 있습니다.
| Provider | API Key | Endpoint |
|---|---|---|
| OpenAI | 필수 | 기본 또는 사용자 지정 |
| Anthropic | 필수 | 기본 또는 사용자 지정 |
| Google Gemini | 필수 | 기본 또는 사용자 지정 |
| Ollama | 선택 | 기본 또는 사용자 지정 |
Provider Key 등록
현재 프로젝트에 맞는 키 그룹에서 Provider를 추가합니다.
AI 설정 열기
사용자 메뉴의 AI 설정을 열고 계정 키 또는 로컬 키 그룹을 선택합니다.
Provider와 인증 입력
OpenAI, Anthropic, Google Gemini 또는 Ollama를 선택하고 API Key와 Endpoint를 입력합니다. Ollama API Key는 선택 사항입니다.
모델 선택
모델 목록을 불러와 선택합니다. 로컬 키는 목록에 없는 사용자 지정 모델명도 직접 입력할 수 있습니다.
저장하고 기본 키 지정
설정을 저장하고 필요한 경우 해당 소스의 기본 Provider Key로 지정합니다.
참고: Chat의 ‘AI 모델 추가’에서도 현재 프로젝트에 맞는 등록 화면으로 이동할 수 있습니다.
키별 옵션
등록한 키마다 모델, Endpoint와 기본 선택을 독립적으로 관리합니다.
- 로컬 키에서는 사용자 지정 모델명을 직접 입력할 수 있습니다.
- 계정 키와 로컬 키는 각 소스 안에서 독립적인 기본 키를 가집니다.
- Max output tokens는 한 응답의 최대 생성량입니다. 값이 너무 작으면 설명이나 SQL이 중간에 잘릴 수 있습니다.
- 계정 키는 월 예산과 기록된 사용량 기반 추정 비용을 지원합니다.
- 로컬 키는 기기에서 직접 Provider를 호출하므로 NeoSQL 월 예산과 비용 집계를 제공하지 않습니다.
주의: 추정 비용은 Provider 청구 내역과 다를 수 있으며 월 예산은 동시 요청을 포함한 절대 상한을 보장하지 않습니다.
Key 관리
키 카드에서 인증 정보와 사용 가능 상태를 관리합니다.
- 편집: API Key, Endpoint, 모델과 옵션을 변경합니다.
- 비활성화: 새 AI 요청에서 해당 키를 선택할 수 없게 합니다.
- 삭제: 더 이상 사용할 키를 제거합니다. 기본 키라면 다른 키를 먼저 기본으로 지정해야 할 수 있습니다.
- 프로젝트를 전환하면 Chat에서 선택할 수 있는 키 그룹도 계정 또는 로컬로 전환됩니다.
저장과 Endpoint 보안
키 소스에 따라 저장 위치와 Endpoint 허용 범위가 다릅니다.
- 계정 키는 계정 저장소에 암호화되며 설정 화면에는 원문을 다시 표시하지 않습니다.
- 로컬 키는 OS 보안 저장소에 보관되며 다른 기기나 계정 프로젝트로 동기화되지 않습니다.
- Web의 계정 키는 HTTPS 공개 Endpoint를 사용합니다. Desktop 로컬 키는 localhost와 사설 Endpoint도 사용할 수 있습니다.
문제 해결
키나 모델을 사용할 수 없으면 현재 프로젝트 유형과 키 그룹부터 확인합니다.
- 전송 버튼이 비활성화되면 현재 프로젝트 소스에 활성 키가 있는지 확인하세요.
- 인증 오류가 나면 API Key의 만료와 Provider 권한을 확인하세요.
- 모델이 보이지 않으면 Endpoint와 인증을 확인하고 다시 불러오거나, 로컬 키에서 사용자 지정 모델명을 입력하세요.
- Web에서 localhost, HTTP 또는 사설 IP Endpoint는 사용할 수 없습니다.