AI 제공자 연결하기

NovelKnow는 특정 모델 제공업체에 묶여 있지 않습니다. API 키를 직접 가져오면 되고, 어떤 모델을 사용할지, 비용이 얼마나 들지는 여러분이 결정하면 됩니다.

빠른 설정 방법

AI 설정 → 제공자 프리셋 클릭 → 키 붙여넣기 → 연결 테스트 → 저장.

프리셋은 기본 URL, 기본 모델, 컨텍스트 창을 자동으로 채워 줍니다. 이 세 가지는 사람들이 가장 자주 실수하는 부분이고, 설정이 작동하지 않는 흔한 원인입니다.

내장 프리셋: DeepSeek, OpenRouter, OpenAI, Kimi / Moonshot, Qwen / DashScope, SiliconFlow, 로컬 Ollama.

OpenAI 호환 엔드포인트라면 모두 작동합니다 — 사용자 지정 옵션을 선택하고 기본 URL을 직접 입력하세요.

저장 후 "모델 동기화"가 제공자에서 실제 모델 목록을 가져옵니다. 그 이후로는 모델 드롭다운이 이 목록에서 채워지므로 모델 이름을 직접 입력할 필요가 없습니다.

자주 사용하는 모델을 즐겨찾기로 표시하면 목록 맨 위로 정렬됩니다.

연결 테스트와 생성 실패에는 제공자의 원본 응답이 포함되어 있어 다음을 구분할 수 있습니다.

오류 내용	보통 의미
`401` / `Incorrect API key`	키가 잘못되었거나 만료됨
`404` / `model does not exist`	모델 이름이 잘못되었거나 계정에 해당 모델 접근 권한이 없음
`429`	속도 제한이 걸렸거나 계정 크레딧이 소진됨
`fetch failed` / `ECONNREFUSED`	서버가 제공자에 연결할 수 없음 — 아래 프록시 참고를 참조하세요

배포 환경에서 제공자에 연결할 수 없다면 AI 설정 대화 상자에서 아웃바운드 프록시를 활성화하세요.

해당 주소는 사용자 컴퓨터가 아니라 배포 서버에서 해석됩니다. 127.0.0.1:7890로 지정하는 것은 서버 자체에서 프록시가 실행 중일 때만 의미가 있습니다.

키는 계정에서 파생된 키로 암호화되며 브라우저에는 마스킹된 형태로만 반환됩니다. 자신의 키 전체를 다시는 볼 수 없으며, 키를 변경하려면 새 키를 붙여넣으세요.