모델과 제공업체
공식 클라우드 모델을 바로 쓰거나 BYOK로 호환 제공업체에 직접 연결하세요. 자신의 컴퓨터에서 실행하는 모델도 가능합니다.
단계
- 가장 간단한 방법은 로그인 후 공식 모델을 바로 사용하는 것입니다. Free를 포함한 모든 요금제에서 키나 설정이 필요 없습니다.
- 설정 → AI 설정 → “텍스트 모델 추가”에서 DeepSeek, OpenRouter, OpenCode Zen, sub2api 또는 사용자 지정 OpenAI 호환 프리셋을 선택하세요.
- 프리셋이 Base URL과 Model ID를 채웁니다. 제공업체에서 만든 키를 붙여 넣고 “연결 테스트”가 성공하면 저장하세요.
- 저장 후 모델을 경량, 일상, 복잡한 작업에 배정해 각 작업에 맞는 모델을 사용하세요.
- 표지와 참고 이미지는 컴퓨터에서 올리며 텍스트 모델로 보내지 않습니다.
BYOK 설정 가이드
BYOK는 NovelThread 크레딧 대신 본인의 제공업체 계정을 사용하며 유효한 Plus 이상 구독이 필요합니다. 직접 과금되며 키는 로컬에 암호화 저장되고 요청은 NovelThread 서버를 거치지 않습니다.
가입부터 집필까지 세 단계
- 1단계: 제공업체에서 가입하고 API 키를 만드세요. 보통 sk-로 시작하며 대부분 한 번만 전체를 보여주므로 즉시 복사해 보관하세요.
- 2단계: 설정 → AI 설정 → 텍스트 모델 추가 → 프리셋 선택으로 URL·ID를 채우고 키를 붙여 넣으세요.
- 3단계: 연결을 테스트하고 성공하면 저장한 뒤 일상 작업 모델로 지정해 집필을 시작하세요.
전체 예시: DeepSeek 연결
공식 DeepSeek API 연결에 입력할 값입니다. 다른 제공업체도 같으며 URL, 모델 ID, 키 발급 사이트만 달라집니다.
- 표시 이름
DeepSeek Official제공업체를 구분할 임의 이름- 제공업체
DeepSeek다음 두 항목 자동 입력- 기본 URL
https://api.deepseek.com프리셋으로 입력하며 /chat/completions는 추가하지 마세요- 모델 ID
deepseek-v4.1-flash제공업체 모델 목록에서 확인하며 OpenRouter는 provider/model-name 형식- API 키
sk-•••••••• (platform.deepseek.com에서 키 생성)전체를 다시 표시하지 않으며 기기에 암호화 저장- 컨텍스트 창 토큰
128000제공업체 한도에 맞춰야 합니다. 낮으면 맥락 손실, 높으면 요청 실패- API 모드
Chat Completions API제공업체가 Responses API를 요구할 때만 변경- 최대 토큰
65536고급 설정. 비워두면 제공업체 기본값 사용
연결 테스트가 실패하면 키 누락·공백, URL 끝의 /chat/completions, 계정 잔액을 먼저 확인하세요.
단계별 구성 가이드
설정 → AI 설정 → 텍스트 모델 추가에서 다음 항목을 확인하세요.
기본 URL필수 · 보통 /v1로 끝남- API 기본 주소입니다. 프리셋으로 채우거나 공식 문서에서 복사하세요. 보통 /v1로 끝나며 예는 https://openrouter.ai/api/v1, https://opencode.ai/zen/v1, http://localhost:11434/v1입니다. /chat/completions를 넣으면 경로가 중복됩니다. DeepSeek는 https://api.deepseek.com 또는 /v1 형식을 지원합니다.
모델 ID필수 · 제공업체 사이트에서 확인- Tells NovelThread which model to call, for example deepseek-v4.1-flash. Presets fill it in; for custom setups, copy the exact ID from the provider’s model list (IDs are case-sensitive). Aggregators usually write it as provider/model-name (e.g. openai/gpt-4o-mini), and some free models end in :free.
API 키필수 · 제공업체 사이트에서 생성- 보통 sk-로 시작하는 인증 정보입니다. 사이트의 API Keys에서 만들고 전체를 한 번만 보여주므로 즉시 복사하세요. 기기에 암호화 저장하며 다시 전체를 표시하지 않습니다. 거절되면 누락, 공백, 삭제된 키인지 확인하세요.
컨텍스트 창 토큰필수 · 제공업체의 한도를 입력- 프롬프트, 이력, 응답을 합친 한 요청의 최대 토큰입니다. 자동 압축 시점을 결정하므로 너무 낮으면 일찍 잊고 높으면 실제 한도를 넘겨 실패합니다. 모델 페이지에서 확인하세요. 예: DeepSeek 128000, Kimi·Gemini 128000 이상.
API 모드기본값 유지- Chat Completions와 Responses API를 지원합니다. DeepSeek, OpenRouter, OpenCode Zen, Moonshot, Ollama, vLLM과 일반 프록시는 대부분 Chat Completions를 쓰므로 기본값을 유지하세요. 제공업체가 Responses를 명시할 때만 바꿉니다. 잘못 선택하면 주로 HTTP 404나 형식 오류가 납니다.
최대 토큰고급 · 응답별 출력 제한- 한 응답의 추론과 본문을 합친 최대 토큰입니다. 기본값은 65,536이며 비우면 제공업체 기본값을 사용합니다. 4096·8192 같은 강제 한도가 있으면 입력해 오류를 피하세요. 충분한 상한으로 긴 장면이 중간에 끊기지 않게 합니다.
공식 링크와 무료 키 발급처
아래 공식 사이트에서 가입하고 키를 만들 수 있습니다. 무료 요금제와 프로모션은 제공업체의 현재 조건을 따릅니다.
- OpenCode Zen기간 한정 무료 / 체험 크레딧
A favorite among developers and writers, frequently offering free endpoints (such as deepseek-v4.1-flash-free). Create a key after signing up, then select the OpenCode Zen preset in NovelThread to fill in the address automatically.
opencode.ai에서 키 발급 → - OpenRouter:free 모델 다수
Llama, Mistral, Qwen 등 :free 공개 모델과 일일 무료 사용량을 제공하는 통합 서비스입니다. 저비용 시험과 블라인드 비교에 적합하며 ID는 provider/model-name:free 형식입니다.
openrouter.ai에서 키 발급 → - Google AI Studio공식 개발자 무료 요금제
Google 개발자 포털은 분당 제한이 있는 무료 Gemini Flash를 제공합니다. 장면 다듬기나 개요 구상에 활용할 수 있습니다.
aistudio.google.com에서 키 발급 → - DeepSeek 플랫폼공식 직접 연결 / 사용량 과금
If you would rather avoid free public routes, the official paid API is the simplest choice: data is not used for training by default (per its policy), and models such as deepseek-v4.1-flash are inexpensive enough for everyday drafting.
platform.deepseek.com에서 키 발급 → - Ollama로컬 실행 / API 비용 없음
공개 모델을 기기에서 완전히 오프라인으로 실행하여 원고가 떠나지 않습니다. URL은 http://localhost:11434/v1, ID는 ollama pull로 받은 모델을 사용하세요.
ollama.com에서 다운로드 →