# WorkBuddy 커스텀 모델 설정 방법

> 3단계로 WorkBuddy에서 사용자 정의 모델을 구성합니다. 모델 추가를 열고 사용자 정의를 선택한 다음 OmniaKey API URL, 키 및 정확한 모델 ID를 입력한 다음 저장하고 확인합니다.

- Canonical HTML: https://omniakey.com/ko/blog/workbuddy-custom-model-setup
- Markdown: https://omniakey.com/ko/blog/workbuddy-custom-model-setup.md
- Published: 2026-08-20 (updated 2026-09-21)
- Author: Kiki, COO at OmniaKey
- Language: ko
- Category: API setup
- Reading time: 8 min
- All posts: https://omniakey.com/blog/llms.txt

---

이 가이드는 WorkBuddy 커스텀 모델 설정 방법을 다루며, 현재 사용자 정의 모델 인터페이스를 사용합니다. WorkBuddy를 열기 전에 OmniaKey API 키와 정확한 모델 ID 하나를 준비하세요.

> **완성된 양식:** **Custom**을 선택하고 Base URL에는 `https://api.omniakey.com/v1`, OmniaKey API 키와 정확한 모델 ID(예: `deepseek-v4-flash`)를 입력합니다.

양식, 저장된 모델 세부정보 및 모델 선택기는 WorkBuddy `v5.3.14`를 실행하는 macOS 앱에서 확인되었습니다. Tencent Cloud의 공식 지침에 따르면 이 기능을 사용하려면 최소한 `v4.22.15`가 필요합니다.

|WorkBuddy 필드|가치|
|-|-|
|공급자|**기타** 그룹 아래의 `Custom`|
|인터페이스 주소|`https://api.omniakey.com/v1`|
|API 키|OmniaKey에서 생성된 키|
|모델명|예: `deepseek-v4-flash`|

## 시작하기 전에 두 가지 항목을 준비하세요

### OmniaKey API 키

OmniaKey에 로그인하고 [API 키 페이지](https://omniakey.com/ko/dashboard/tokens)를 엽니다.

1. **키 만들기**를 선택합니다.
2. 이름을 `WorkBuddy`로 지정한 다음 적절한 제한과 만료를 설정합니다.
3. 키를 생성하고 즉시 새 키를 복사하세요.

자격 증명을 WorkBuddy에 붙여 넣을 때까지 키 대화 상자를 열어 두십시오. 스크린샷, 채팅 메시지, 공개 파일에 키를 넣지 마세요.

계정에는 사용 가능한 잔액이나 평가판 크레딧도 필요합니다. 키를 생성하면 자격 증명만 생성됩니다. 이는 해당 계정이 요청에 자금을 조달할 수 있다는 것을 보장하지 않습니다. 동일한 키를 다른 도구에서도 사용할 수 있습니다. [Cherry Studio API 설정](https://omniakey.com/ko/blog/cherry-studio-api-setup), [Cline 커스텀 API 키](https://omniakey.com/ko/blog/cline-custom-api-key), [Claude Code 설정](https://omniakey.com/ko/blog/claude-code-setup) 가이드를 참고하세요.

### 정확한 모델 ID

[OmniaKey 모델 카탈로그](https://omniakey.com/ko/models)를 열고 현재 사용 가능한 모델을 선택한 후 페이지에 표시된 모델 ID를 복사하세요. 첫 번째 테스트에는 다음을 사용하세요.

```text
deepseek-v4-flash
```

ID가 정확히 일치해야 합니다. 표시 이름 `DeepSeek V4 Flash`를 입력하거나 하이픈을 제거하거나 더 짧은 별칭을 만들지 마십시오.

## 1 단계: 모델 추가 열기

WorkBuddy를 시작하고 다음을 엽니다.

```text
System Settings → Models → + Add model
```

모델 페이지의 오른쪽 상단에서 **+ 모델 추가**를 선택합니다.

![오른쪽 상단에 모델 추가 버튼이 있는 WorkBuddy 모델 설정 페이지](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/01-open-model-settings.2eba6570.1000.webp)

_1 단계: 시스템 설정 → 모델 → + 모델 추가._

새 작업의 맨 아래에서 입력할 수도 있습니다.

```text
Model picker → + Configure custom model
```

두 항목 모두 사용할 수 없는 경우 WorkBuddy를 `v4.22.15` 이상 버전으로 업데이트하세요. Tencent Cloud의 현재 지침에는 인터페이스에 대해 최소한 이 버전이 필요합니다.

## 2 단계: Custom을 선택하고 4개의 필드를 완성합니다.

양식을 위에서 아래로 채웁니다.

### 1. 맞춤형 공급자 선택

공급자 메뉴를 열고 다음을 선택합니다.

```text
Custom
```

`v5.3.14`에서는 **기타** 그룹 아래에 나타납니다. 내장된 OpenAI, Tencent Cloud Token Plan 또는 다른 공급자를 선택하지 마십시오. 해당 프로필은 OmniaKey 인터페이스 주소를 사용하지 않기 때문입니다.

![WorkBuddy 공급자 메뉴 하단에 있는 사용자 정의 공급자 옵션](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/02-choose-custom-provider.fabcb941.560.webp)

_2 단계: 공급자 메뉴 하단으로 스크롤하고 기타 아래에서 사용자 지정을 선택합니다._

### 2. `/v1`를 통해 주소를 입력하세요.

**인터페이스 주소** 또는 **Base URL**에 다음을 정확하게 입력합니다.

```text
https://api.omniakey.com/v1
```

> **회색 자리 표시자를 복사하지 마세요.** 예시는 `/v1/chat/completions`로 끝나지만, 이 필드에 사용할 OmniaKey Base URL은 `https://api.omniakey.com/v1` 입니다.

### 3. API 키 붙여넣기

OmniaKey에서 복사한 키를 **API 키**에 붙여넣습니다. 따옴표, 공백 또는 `Bearer`라는 단어를 추가하지 마십시오. 키 값만 입력하세요.

### 4. 모델명을 입력하세요

**모델 이름** 또는 **Model ID**에 정확한 카탈로그 ID를 입력하세요.

```text
deepseek-v4-flash
```

이제 핵심 양식은 다음과 같아야 합니다.

```text
Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash
```

![WorkBuddy다음으로 채워진 사용자 정의 모델 양식OmniaKey인터페이스 주소 및 deepseek-v4-flash 모델 이름](https://omniakey.com/_img/blog/workbuddy-custom-model-setup/03-fill-omniakey-fields.addb54d9.560.webp)

_완성된 예시입니다. API 키는 스크린샷에서 의도적으로 비어 있습니다. WorkBuddy를 구성할 때 자신의 OmniaKey 키를 붙여넣으세요._

첫 번째 연결 테스트에서는 나머지 필드를 기본값으로 두고 **사용자 지정 프로토콜**이 꺼져 있는지 확인하세요. `v5.3.14`에서 새 양식은 Tool calling 켜짐, 이미지 입력 ​​꺼짐, 추론 모드 꺼짐, 사용자 정의 프로토콜 꺼짐, 공급자 기본 입력 및 출력 제한으로 시작됩니다. 검증된 `deepseek-v4-flash` 사전 설정이 아래에 표시됩니다.

## 3 단계: 모델을 저장하고 선택하고 테스트합니다.

**저장**을 선택하고 새 작업으로 돌아갑니다. 하단의 모델 선택기를 열고 사용자 정의 모델 섹션을 찾아 `deepseek-v4-flash`를 선택합니다.

짧은 테스트 메시지 하나를 보내십시오:

```text
Reply with exactly: Connection successful
```

정상적인 응답은 설정의 네 부분을 동시에 확인합니다.

1. WorkBuddy는 사용자 정의 공급자를 저장했습니다.
2. Base URL가 정확합니다.
3. API 키가 승인되었으며 사용 가능한 크레딧이 있습니다.
4. 키는 선택한 모델 ID에 액세스할 수 있습니다.

마지막으로 [OmniaKey Usage](https://omniakey.com/ko/dashboard/usage)를 열고 예상 모델과 함께 호출이 나타나는지 확인하세요. 그러면 WorkBuddy에서 OmniaKey까지의 확인 루프가 닫힙니다.

저장된 모델이 즉시 표시되지 않으면 선택기를 닫았다가 다시 엽니다. 그래도 표시되지 않으면 WorkBuddy를 완전히 종료하고 다시 시작하세요.

## 첫 번째 테스트에 권장되는 고급 설정

기본 채팅이 작동하기 전에 여러 기능 제어를 변경하지 마십시오. WorkBuddy `v5.3.14`의 새로운 사용자 정의 모델은 다음으로 시작됩니다.

|옵션|새로운 형식의 기본값|
|-|-|
|Tool calling|켜짐|
|이미지 입력|끄기|
|추론 모드|끄기|
|맞춤 프로토콜|끄기|
|입력 및 출력 제한|공급자 기본값|

URL, 키, 모델 이름을 먼저 확인하려면 이러한 기본값을 사용하세요. 그런 다음 모델의 기능을 조정합니다.

### 검증된 `deepseek-v4-flash` 사전 설정

저장된 모델과 성공적인 로컬 응답에는 다음 구성이 사용되었습니다.

|옵션|`deepseek-v4-flash` 설정|
|-|-|
|Tool calling|끄기|
|이미지 입력|끄기|
|추론 모드|**켜기**|
|추론만|끄기|
|추론 비활성화 허용|**켜기**|
|맞춤 프로토콜|**해제**|
|기본 추론 노력|`Auto (use request-layer default)`|
|지원되는 추론 노력|낮음, 중간, 높음, 매우 높음 및 최대를 선택하지 않은 상태로 둡니다.|
|입력 및 출력 제한|공급자 기본값|

WorkBuddy는 추론만, 추론 비활성화 허용 및 추론 모드가 활성화된 후 노력 제어를 표시합니다. 첫 번째 테스트에서는 Auto에 노력을 맡기십시오.

### 도구 호출을 활성화해야 하는 경우

WorkBuddy가 파일을 읽거나 커넥터를 사용하거나 에이전트 작업을 수행해야 하는 경우 **Tool calling**를 활성화합니다. 모델은 구조화된 도구 호출도 지원해야 합니다. `deepseek-v4-flash`는 현재 OmniaKey 카탈로그에서 도구 지원을 제공하므로 기본 채팅이 작동한 후에 이를 활성화하고 읽기 전용 작업으로 시작하세요. 연결 전용 채팅 테스트에서는 꺼진 상태로 유지될 수 있습니다.

### 이미지 입력을 활성화하는 경우

이미지를 허용하는 것으로 명시적으로 표시된 모델에 대해서만 활성화하십시오. 클라이언트 스위치는 텍스트 전용 모델에 비전 기능을 추가할 수 없습니다.

### 추론 모드를 활성화해야 하는 경우

카탈로그나 모델 문서에 추론, 사고 또는 유사한 모드가 명시적으로 나열되어 있는 경우 활성화하세요. 자동 노력을 유지하고 추론 비활성화를 허용합니다. 지원되지 않는 노력 값을 추가하지 말고 추론 전용 모드를 일반 작업의 기본값으로 설정하지 마세요.

## 다른 모델 추가

작업 모델 항목을 덮어쓰지 마십시오. **모델 추가**를 다시 열고 동일한 OmniaKey URL과 API 키를 유지하고 정확한 모델 ID만 교체한 후 다른 맞춤 모델로 저장하세요.

다음 모델을 추가하기 전에 하나의 모델을 확인하세요. 문제가 나타나면 어떤 저장된 항목이 문제를 일으켰는지 명확하게 알 수 있습니다.

## 증상별 문제 해결

### 맞춤 모델 구성이 누락되었습니다.

먼저 WorkBuddy 버전을 확인하세요. `v4.22.15` 이상으로 업데이트한 다음 새 작업 모델 선택기나 **시스템 설정 → 모델**에서 찾아보세요.

### HTTP 401, 승인되지 않았거나 잘못된 API 키

OmniaKey 키를 다시 복사합니다. 공백을 확인하고 `Bearer`를 붙여넣지 않았는지 확인하세요. 키가 활성화되어 있고 만료되지 않았는지, 계정 잔액과 키 한도를 모두 사용할 수 있는지 확인하세요.

모델 ID를 변경해도 `401`가 수정되지 않습니다. 모델 선택이 중요해지기 전에 인증이 실패했습니다.

### HTTP 404 또는 엔드포인트를 찾을 수 없습니다.

주소는 정확히 다음과 같아야 합니다.

```text
https://api.omniakey.com/v1
```

베어 도메인을 사용하거나, `/v1`를 복제하거나, `/chat/completions`를 추가하지 마세요. 또한 **맞춤 프로토콜**이 꺼져 있는지 확인하세요.

### 모델을 찾을 수 없음 또는 `UNKNOWN_MODEL`

[실시간 모델 카탈로그](https://omniakey.com/ko/models)에서 ID를 다시 복사하세요. 표시 이름, 추측된 별칭 또는 폐기된 ID가 유효한 현재 모델 ID가 아닙니다.

### 채팅은 작동하지만 도구는 작동하지 않습니다.

기본 모델 연결이 이미 작동 중입니다. WorkBuddy의 Tool calling 스위치와 모델의 도구 기능을 확인하세요. API 키 또는 URL을 다시 입력하면 도구 지원이 추가되지 않습니다.

### 이미지 입력 실패

두 조건이 모두 충족되어야 합니다. 모델이 이미지를 지원하고 WorkBuddy의 이미지 입력 제어가 활성화됩니다.

### 저장 후 모델이 누락되었습니다.

**저장**을 선택했는지 확인한 다음 모델 선택기를 다시 엽니다. 필요한 경우 WorkBuddy를 다시 시작하십시오. 구성 항목 자체를 사용할 수 없는 경우 클라이언트 버전을 다시 확인하세요.

## 자주 묻는 질문

### WorkBuddy는 어떤 OmniaKey URL을 사용해야 합니까?

사용할 주소는 `https://api.omniakey.com/v1`. 이 값은 Base URL이며 작업 경로는 WorkBuddy가 추가합니다.

### `models.json` 파일이 필요합니까?

아니요. 이 가이드는 현재 **맞춤 모델 구성** 인터페이스를 따릅니다. 이전 로컬 구성 파일 지침에서는 다른 설정 경로를 설명합니다.

### GPT, Claude, Gemini 또는 다른 모델을 구성할 수 있습니까?

예, 모델이 현재 OmniaKey에 나열되어 있고 OpenAI 호환 경로를 지원하는 경우입니다. 동일한 URL을 유지하고 정확한 카탈로그 모델 ID를 사용하세요.

### 이 양식에 MCP가 구성되어 있습니까?

아니요. 이 양식은 API 모델을 구성합니다. MCP와 커넥터는 별도의 WorkBuddy 설정입니다. 해당 도구를 추가하기 전에 기본 모델 응답을 설정하십시오.

## 검증된 참고자료

- [Tencent Cloud: WorkBuddy 구성 및 사용](https://cloud.tencent.com/document/product/1823/130064)
- [OmniaKey OpenAI 호환 API 참조](https://docs.omniakey.com/en/api/openai-compatible)
- [OmniaKey 실시간 모델 카탈로그](https://omniakey.com/ko/models)