모델 연결과 파라미터
BYOK: 키는 기기 보안 저장소에; 요청은 설정한 주소로 직결됩니다.
유료 API가 없으면 무료 클라우드; PC 배포는 로컬 모델.
모델 연결
경로: 설정 → 모델 → 모델 연결
| 조작 | 설명 |
|---|---|
| 새로 만들기 | 플랫폼, 키, Base URL, 모델 |
| 편집 / 복사 / 삭제 | 목록 오른쪽 메뉴 |
| 기본값으로 설정 | 새 대화의 기본 |
| 테스트 | 저장 전 또는 편집 페이지 「테스트」. 텍스트 채팅 모델이어야 함; TTS / 이미지 전용 ID（예 Gemini *-tts）는 텍스트 대화 미지원 → 오류 · textOutputUnsupported |
플랫폼 유형（자주 씀）
| 옵션（문서는 App 기준） | 용도 |
|---|---|
| 각 클라우드 프리셋 | 국내/국제 Base URL 자동 |
| Custom (OpenAI) | 로컬 Ollama / LM Studio, 호환 게이트웨이 |
| Custom Gemini / Anthropic | 해당 프로토콜 엔드포인트 |
다중 사이트 플랫폼은 「국제 사이트 사용」전환 가능. 로컬: MiniTavern 연결 · 도구 개요.
모델 설정（전역 파라미터）
경로: 설정 → 모델 설정
자주 쓰는 항목（이름은 App 기준）:
- 기억 길이（히스토리 수）
- 응답 토큰（max tokens, 상한 128000; 일부 Claude 장면에서는 None 금지）
- Temperature, Top-P / Top-K
- 스트리밍 여부
세션별 덮어쓰기
경로: 대화 → 설정 → 모델 연결 / 파라미터
한 채팅만 연결·샘플링을 바꿀 수 있으며 전역 기본값은 유지됩니다.
채팅 설정의 이미지 인식
경로: 설정 → 채팅 → 이미지 인식 설정
단톡은 채팅 설정 → 이미지 인식과 표시에서 기본을 따르거나 단독 덮어쓰기（묘사 모델·프롬프트는 전역）.
- 「이미지 묘사」끄기: 멀티모달로 그림을 모델에 직접 전달（비전 지원 필요）.
- 켜기: 현재 채팅 주 모델이 이미지 파라미터를 지원하지 않을 때만 — 묘사 모델이 먼저 그림을 텍스트로（인물 인식과 같은 요청 가능）, 그다음 주 모델; 묘사 결과는 캐시 재사용. 주 모델이 비전을 지원하면 여전히 멀티모달 직전, 이 스위치는 막지 않음.
이미지 미지원 주 모델 + 묘사 켠 뒤 순서: 묘사（+인물）→ 주 채팅（스마트/키워드 이미지 응답이 있으면 이미지 프롬프트 첨부）→ 응답에 이미지 데이터가 있으면 바이패스 생성.
「현재 모델이 이미지를 지원하지 않음」→ 오류 · visionUnsupported.
이미지 생성（연결 / 응답 이미지 / 키워드）
경로: 설정 → 이미지 생성
- 이미지 연결 / 이미지 설정: API, 크기/품질, 생성 수（
/imagine만）, 강화/네거티브 프롬프트（/imagine과 첨부 메뉴 생성만; 기본 화질 단어 / 저품질·흐림·여분 손가락·워터마크 등） - 응답 이미지（이미지 설정 안）: 먼저 스위치, 그다음 트리거 방식. 끄면 채팅이 자동 출도하지 않음（슬래시, 첨부 메뉴, 말풍선 길게 누르기는 영향 없음）
- 스마트 판단: 모델이 이 라운드에 이미지를 낼지 판단; 구도는 장면별（폰 셀카 3:4, 카메라 3:2）, 히트 시 1장. 첨부 가능（예 「이런 스타일로」）— 스타일 참고이며 캐릭터/유저 신원 판정을 대체하지 않음
- 키워드 트리거: 사용자 메시지가 키워드 규칙에 맞으면 출도（첨부 가능）; 화면·구도는 현재 대화 기준, 히트 시 1장
- 키워드 트리거 이미지: 규칙 설정. 실제로 쓰려면 이미지 설정에서 응답 이미지를 켜고 키워드 트리거를 선택
채팅에서 이미지 생성:
| 입구 | 설명 |
|---|---|
/imagine 프롬프트 | 주 채팅 모델이 대화 관련 여부·캐릭터/유저 참고 필요 여부를 판단한 뒤 프롬프트를 만들어 생성. 첨부는 참고용이며 말로는 나가지 않음. 장수는 이미지 설정의 「생성 수」. 실패 시 버블이 남고 재시도 |
/imagine scene / 첨부 → 스토리 기준 | 최근 대화로 현재 장면, 1장 |
/imagine last / 첨부 → 마지막 메시지 | 마지막 메시지 기준, 1장 |
| 첨부 → 배경 생성 | 환경 배경 1장; 완료 후 채팅 배경으로 설정 가능 |
| 말풍선 길게 누르기 → 이미지 | 해당 버블 기준, 1장 |
이미지 연결이 없으면 첨부 메뉴 네 가지 모드와 /imagine 전송 시 「설정으로 / 취소」팝업（입력란은 비우지 않음）. 스마트/키워드 자동 출도는 Toast. 응답 이미지를 켤 때 연결이 없으면 팝업하고 스위치는 꺼진 채.
예: 「셀카 한 장」은 캐릭터 참고+대화 맥락; 「강아지 사진」은 독립 요청으로 캐릭터 얼굴을 씌우지 않음.
로컬 A1111 / ComfyUI: 이미지 모델 배포 · App 연결.
클라우드 무료: 무료 클라우드 · 이미지.
오류 입구
테스트·채팅 실패 → Toast / 버블 → 상세 보기（오류 코드 + 원인 + 제안）→ 오류 코드.