WorkBuddy 커스텀 모델 설정 방법
표시된 순서대로 URL, API 키, 모델명을 입력한 후 연결이 완료되었는지 확인하세요.
이 가이드는 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 키 페이지를 엽니다.
- 키 만들기를 선택합니다.
- 이름을
WorkBuddy로 지정한 다음 적절한 제한과 만료를 설정합니다. - 키를 생성하고 즉시 새 키를 복사하세요.
자격 증명을 WorkBuddy에 붙여 넣을 때까지 키 대화 상자를 열어 두십시오. 스크린샷, 채팅 메시지, 공개 파일에 키를 넣지 마세요.
계정에는 사용 가능한 잔액이나 평가판 크레딧도 필요합니다. 키를 생성하면 자격 증명만 생성됩니다. 이는 해당 계정이 요청에 자금을 조달할 수 있다는 것을 보장하지 않습니다.
정확한 모델 ID
OmniaKey 모델 카탈로그를 열고 현재 사용 가능한 모델을 선택한 후 페이지에 표시된 모델 ID를 복사하세요. 첫 번째 테스트에는 다음을 사용하세요.
deepseek-v4-flash
ID가 정확히 일치해야 합니다. 표시 이름 DeepSeek V4 Flash를 입력하거나 하이픈을 제거하거나 더 짧은 별칭을 만들지 마십시오.
1 단계: 모델 추가 열기
WorkBuddy를 시작하고 다음을 엽니다.
System Settings → Models → + Add model
모델 페이지의 오른쪽 상단에서 + 모델 추가를 선택합니다.
새 작업의 맨 아래에서 입력할 수도 있습니다.
Model picker → + Configure custom model
두 항목 모두 사용할 수 없는 경우 WorkBuddy를 v4.22.15 이상 버전으로 업데이트하세요. Tencent Cloud의 현재 지침에는 인터페이스에 대해 최소한 이 버전이 필요합니다.
2 단계: Custom을 선택하고 4개의 필드를 완성합니다.
양식을 위에서 아래로 채웁니다.
1. 맞춤형 공급자 선택
공급자 메뉴를 열고 다음을 선택합니다.
Custom
v5.3.14에서는 기타 그룹 아래에 나타납니다. 내장된 OpenAI, Tencent Cloud Token Plan 또는 다른 공급자를 선택하지 마십시오. 해당 프로필은 OmniaKey 인터페이스 주소를 사용하지 않기 때문입니다.
2. /v1를 통해 주소를 입력하세요.
인터페이스 주소 또는 Base URL에 다음을 정확하게 입력합니다.
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를 입력하세요.
deepseek-v4-flash
이제 핵심 양식은 다음과 같아야 합니다.
Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash
첫 번째 연결 테스트에서는 나머지 필드를 기본값으로 두고 사용자 지정 프로토콜이 꺼져 있는지 확인하세요. v5.3.14에서 새 양식은 Tool calling 켜짐, 이미지 입력 꺼짐, 추론 모드 꺼짐, 사용자 정의 프로토콜 꺼짐, 공급자 기본 입력 및 출력 제한으로 시작됩니다. 검증된 deepseek-v4-flash 사전 설정이 아래에 표시됩니다.
3 단계: 모델을 저장하고 선택하고 테스트합니다.
저장을 선택하고 새 작업으로 돌아갑니다. 하단의 모델 선택기를 열고 사용자 정의 모델 섹션을 찾아 deepseek-v4-flash를 선택합니다.
짧은 테스트 메시지 하나를 보내십시오:
Reply with exactly: Connection successful
정상적인 응답은 설정의 네 부분을 동시에 확인합니다.
- WorkBuddy는 사용자 정의 공급자를 저장했습니다.
- Base URL가 정확합니다.
- API 키가 승인되었으며 사용 가능한 크레딧이 있습니다.
- 키는 선택한 모델 ID에 액세스할 수 있습니다.
마지막으로 OmniaKey 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 또는 엔드포인트를 찾을 수 없습니다.
주소는 정확히 다음과 같아야 합니다.
https://api.omniakey.com/v1
베어 도메인을 사용하거나, /v1를 복제하거나, /chat/completions를 추가하지 마세요. 또한 맞춤 프로토콜이 꺼져 있는지 확인하세요.
모델을 찾을 수 없음 또는 UNKNOWN_MODEL
실시간 모델 카탈로그에서 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 설정입니다. 해당 도구를 추가하기 전에 기본 모델 응답을 설정하십시오.