모델
API 키, 내 엔드포인트, 제공 모델을 등록하고 프로필별로 다르게 설정합니다.
설정 → 모델 화면(온보딩의 모델 단계와 같은 화면)에서 비서가 답을 만들 때 쓸 인증 출처와 모델을 정합니다.
API 키
Anthropic, OpenAI 탭에서 각각 API 키를 등록합니다. 키는 암호화되어 저장되고 화면에는 마지막 네 자리만 보입니다. 저장하면 곧바로 1회 호출로 검증하며, 확인 중 / 확인됨 / 키 오류 상태로 표시됩니다.
키는 워커의 프록시 안에서만 쓰이고 모델을 실행하는 프로세스에는 직접 전달되지 않습니다.
내 엔드포인트
vLLM, Ollama, LM Studio, OpenRouter처럼 OpenAI 호환 API를 내놓는 서버를 연결할 수 있습니다. 등록할 때 다음을 입력합니다.
- 이름
- 모델 id
- Base URL (
/v1까지 포함), 예:
http://100.80.63.3:8000/v1
- API 키 (없으면 비워 둠)
- API 형식:
chat(Chat Completions) 또는responses(Responses API)
주소는 Tiffy 워커가 닿을 수 있어야 합니다. tailnet, 터널, 클라우드 주소는 되지만 로컬 PC의 localhost는 닿지 않습니다. 사설 대역 주소는 서버가 자동으로 차단합니다(forbidden_host 오류).
저장하면 곧바로 연결을 확인하고, 확인 중 / 확인됨 / 연결 실패로 표시됩니다. 작은 모델은 도구 호출이 불안정할 수 있습니다.
프로필별 설정
Tiffy에는 두 개의 내장 프로필이 있고, 각각 다른 인증 출처와 모델을 쓸 수 있습니다.
- 비서 - 채널의 자유 문장 명령을 받는 프로필
- 기록 담당 - 기록 담당(사서)이 쓰는 인증 출처와 모델. 비서와 다르게 둘 수 있습니다.
각 프로필에서 고를 수 있는 인증 출처는 다음과 같습니다.
| 인증 출처 | 설명 |
|---|---|
| 내 API 키 | 위에서 키를 하나 이상 등록해야 고를 수 있습니다 |
| 내 엔드포인트 (OpenAI 호환) | 등록한 엔드포인트의 모델과 API 형식을 그대로 씁니다. 백엔드는 Codex 드라이버로 고정됩니다 |
| Tiffy 제공 모델 | 운영자가 연 모델이 있을 때 고를 수 있습니다. 키 없이 쓰고, 화면에 보이는 판매가(입력/출력, 1M 토큰당)로 청구액이 계산됩니다 |
| 운영자 구독 (Claude/Codex 로그인) | 운영자가 허용한 경우에만 보이는 출처입니다 |
| 선택 안 함 | 이 프로필의 작업은 인증 출처가 없어 보류됩니다 |
인증 출처는 자동으로 바뀌지 않으며, 바꾸면 다음 호출부터 적용됩니다. 모델을 고르는 콤보박스에는 등록한 키로 쓸 수 있는 Anthropic/OpenAI 모델, Tiffy 제공 모델, 등록한 엔드포인트가 함께 나열됩니다.