AI Provider Key 설정

계정 프로젝트용 계정 키와 로컬 프로젝트용 로컬 키를 등록하고 관리합니다.

계정 키와 로컬 키

두 키 그룹은 저장 위치와 사용 프로젝트가 다르며 서로 대체되지 않습니다.

구분계정 키로컬 키
사용 범위계정 프로젝트로컬 프로젝트
저장계정에 암호화 저장OS 보안 저장소
기기 범위로그인한 환경에서 사용현재 기기 전용

참고: 로그인한 Desktop에서는 두 그룹을 함께 관리하지만, 실제 요청에 사용할 소스는 현재 프로젝트 유형이 결정합니다. Web은 계정 키만, 비로그인 Desktop은 로컬 키만 사용합니다.

지원 Provider

Provider별 기본 또는 사용자 지정 Endpoint를 사용할 수 있습니다.

ProviderAPI KeyEndpoint
OpenAI필수기본 또는 사용자 지정
Anthropic필수기본 또는 사용자 지정
Google Gemini필수기본 또는 사용자 지정
Ollama선택기본 또는 사용자 지정

Provider Key 등록

현재 프로젝트에 맞는 키 그룹에서 Provider를 추가합니다.

1

AI 설정 열기

사용자 메뉴의 AI 설정을 열고 계정 키 또는 로컬 키 그룹을 선택합니다.

2

Provider와 인증 입력

OpenAI, Anthropic, Google Gemini 또는 Ollama를 선택하고 API Key와 Endpoint를 입력합니다. Ollama API Key는 선택 사항입니다.

3

모델 선택

모델 목록을 불러와 선택합니다. 로컬 키는 목록에 없는 사용자 지정 모델명도 직접 입력할 수 있습니다.

4

저장하고 기본 키 지정

설정을 저장하고 필요한 경우 해당 소스의 기본 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는 사용할 수 없습니다.