# 모델 및 제공업체

## 개요

Neotask는 다양한 AI 모델 제공업체를 지원합니다. Anthropic, OpenAI, Google의 클라우드 호스팅 모델을 사용하거나, Ollama 또는 vLLM을 통해 로컬 모델을 실행하거나, OpenAI 호환 API 엔드포인트에 연결할 수 있습니다.

## 지원되는 제공업체

### 클라우드 제공업체

| 제공업체 | 모델 | 인증 |
|----------|--------|------|
| **Anthropic** | Claude Opus 4.6, Claude Sonnet 4.1, Claude Haiku 4.5 | API 키 또는 설정 토큰 |
| **OpenAI** | GPT-5.2, GPT-5.1, GPT-4 Turbo, GPT-4 | API 키 |
| **Google (Gemini)** | Gemini 3 Pro, Gemini 2 Flash, Gemini 1 Pro | API 키 또는 OAuth |
| **Together AI** | 다양한 오픈 웨이트 모델 (Llama, Mixtral 등) | API 키 |
| **Moonshot (Kimi)** | Moonshot v1 (32K, 128K 컨텍스트) | API 키 |
| **OpenRouter** | 여러 제공업체의 100개 이상 모델 | API 키 |
| **DeepSeek** | DeepSeek Chat, DeepSeek Coder | API 키 |
| **OpenCode Zen** | Claude 변형, 커스텀 튜닝 모델 | API 키 |

### 로컬 모델 제공업체

| 제공업체 | 설명 |
|----------|-------------|
| **Ollama** | 로컬에서 오픈 웨이트 모델 실행 (Llama, Mistral 등) |
| **vLLM** | 고처리량 로컬 추론 서버 |
| **LiteLLM** | 100개 이상 제공업체를 위한 통합 프록시 |

### 커스텀 제공업체

기본 URL과 API 키를 지정하여 OpenAI 호환 또는 Anthropic 호환 API에 연결합니다. 자체 호스팅 추론 서버, 엔터프라이즈 프록시 엔드포인트, 타사 모델 API와 작동합니다.

## 모델 구성

### 기본 모델
모든 에이전트의 기본 모델을 설정합니다. 각 에이전트는 자체 기본 모델로 이를 재정의할 수 있습니다.

### 폴백 체인
우선순위가 있는 폴백 모델 목록을 구성합니다. 기본 모델이 실패(속도 제한, 중단, 인증 오류)하면 Neotask가 자동으로 체인의 다음 모델을 시도합니다.

### 이미지 모델
이미지 분석 및 생성을 위한 별도 모델 구성. Claude Vision, GPT-4 Vision, DALL-E 3를 지원합니다.

### 모델 별칭
긴 모델 이름의 단축키를 만듭니다. 예를 들어 `fast`를 `anthropic/claude-haiku-4-5`로 별칭을 지정하여 빠른 참조가 가능합니다.

### 에이전트별 재정의
각 에이전트는 전체 기본값과 독립적으로 자체 모델 구성을 가질 수 있습니다.

### 모델 허용 목록
에이전트가 사용할 수 있는 모델을 제한합니다. 비용 제어 또는 규정 준수에 유용합니다.

## API 키 관리

### 키 소스 (우선순위 순서)
1. 라이브 재정의 키 (최고 우선순위)
2. 쉼표로 구분된 키 목록 (순환)
3. 기본 키
4. 번호가 매겨진 키 (key_1, key_2 등)

### 자동 키 순환
속도 제한에 도달하면 Neotask가 자동으로 다음 사용 가능한 키로 전환합니다. 속도 제한이 아닌 실패는 순환 없이 즉시 오류를 반환합니다.

### 제공업체별 구성
각 제공업체는 자체 API 키 세트, 인증 프로필, 모델별 설정을 가질 수 있습니다.

## 제공업체 인증 방법

| 방법 | 설명 |
|--------|-------------|
| **API 키** | 표준 베어러 토큰 인증 |
| **설정 토큰** | 인터랙티브 인증 흐름 (Anthropic) |
| **OAuth** | 갱신 토큰을 사용한 위임 인증 (Google, GitHub Copilot) |
| **토큰 붙여넣기** | 특화된 제공업체를 위한 수동 토큰 입력 |

## 모델 선택 우선순위

에이전트가 LLM 호출을 해야 할 때 모델은 다음 순서로 선택됩니다:

1. 에이전트별 재정의 (설정된 경우)
2. 전체 기본 모델
3. 모델 허용 목록 (구성된 경우 옵션 제한)
4. 첫 번째 사용 가능한 모델 (폴백)

## 제공업체별 도구 제한

특정 모델이나 제공업체에 사용 가능한 도구를 제한할 수 있습니다. 예를 들어 신뢰도가 낮은 모델은 파일 작업만 허용하고, Claude는 전체 도구 접근을 허용합니다.