# 자체 키 사용(BYOK)

## 개요

BYOK 모드를 사용하면 Neotask의 관리형 인프라 대신 지원되는 AI 제공업체의 자체 API 키를 사용할 수 있습니다. 이를 통해 사용하는 모델에 대한 완전한 제어권, 제공업체로부터의 직접 청구, BYOK 사용 시 크레딧에서 20% 플랫폼 수수료가 적용됩니다.

## 작동 방식

1. 선호하는 제공업체에서 **API 키를 받습니다**
2. Neotask 설정에서 **키를 추가합니다**
3. **에이전트**가 모든 LLM 호출에 해당 키를 사용합니다
4. **청구**가 직접 제공업체 계정으로 이루어집니다

자체 키를 제공하지 않으면 Neotask은 구독 플랜을 통해 사용량이 추적 및 청구되는 공유 풀링된 키를 사용합니다.

## 지원되는 제공업체

| 제공업체 | 모델 | 키 받는 방법 |
|----------|--------|-----------------|
| **Anthropic** | Claude Opus 4.6, Claude Sonnet 4.1, Claude Haiku 4.5 | [console.anthropic.com](https://console.anthropic.com) |
| **OpenAI** | GPT-5.2, GPT-5.1, GPT-4 Turbo, GPT-4, DALL-E 3 | [platform.openai.com](https://platform.openai.com) |
| **Google AI** | Gemini 3 Pro, Gemini 2 Flash, Gemini 1 Pro | [aistudio.google.com](https://aistudio.google.com) |
| **OpenRouter** | 여러 제공업체의 100개 이상 모델 | [openrouter.ai](https://openrouter.ai) |
| **DeepSeek** | DeepSeek Chat, DeepSeek Coder | [platform.deepseek.com](https://platform.deepseek.com) |

## 키 보안

- **서버 측 저장**, 키는 로컬 일반 텍스트 파일이 아닌 Neotask 라이선스 서버에 암호화되어 저장됩니다
- **HMAC 서명 요청**, 키 관리 작업은 기기 시크릿으로 서명됩니다
- **마스킹된 표시**, UI에는 키의 마지막 4자만 표시됩니다
- **기기 바인딩**, 키는 추가 보안을 위해 기기 + 라이선스와 연결됩니다

## BYOK의 이점

| 기능 | 관리형(기본값) | BYOK |
|---------|-------------------|------|
| 설정 필요 | 없음 | 제공업체에서 API 키 받기 |
| 청구 | Neotask 플랜을 통해 | 제공업체에 직접 |
| 모델 접근 | 플랜에 포함된 모델 | 키가 지원하는 모든 모델 |
| 요금 | 구독에 포함 | 제공업체 공개 요금 |
| 속도 제한 | 공유 풀 제한 | 계정 한도 |
| 비용 제어 | 앱의 일일 예산 | 제공업체 대시보드 + 앱 예산 |

## BYOK를 사용해야 할 때

- 관리형 플랜에서 사용할 수 없는 **특정 모델을 원할 때**
- 제공업체와의 **기존 API 크레딧** 또는 엔터프라이즈 계약이 있을 때
- 공유 풀이 제공하는 것보다 **높은 속도 제한을 원할 때**
- 제공업체로부터의 **직접 청구를 선호할 때**
- 키가 클라우드 계정 내에 있어야 한다는 **조직 요구사항이 있을 때**