DeepSeek Harness 타사 키 설정 — APIMaster.ai 사용자 지정 프로바이더
DeepSeek Harness(dsh)에 APIMaster.ai OpenAI 호환 API 키를 추가하는 방법. Settings → Models → Add a custom provider에서 Base URL, API 키, 모델 ID를 입력한 뒤 채팅에서 모델을 선택하세요.
DeepSeek Harness(dsh)는 DeepSeek의 오픈소스 로컬 에이전트 프레임워크입니다. Web UI 기본 주소는 http://127.0.0.1:3080입니다. 내장 DeepSeek 카드는 공식 키만 받습니다. APIMaster의 GPT / Claude / DeepSeek 등 마켓플레이스 모델을 쓰려면 Add a custom provider가 필요합니다.
먼저 API 키를 받으세요. 키는
$DSH_HOME/.credentials.yaml(기본~/.dsh/)에만 저장됩니다. 채팅이나 스크린샷에 공유하지 마세요.
사전 준비
- Node.js
22.19+또는24+. - Web UI 실행:
npx @deepseek-ai/dsh web
터미널에 출력된 주소(보통 http://127.0.0.1:3080)를 엽니다.
3. APIMaster 콘솔에서 API Key 복사.
4. 마켓플레이스의 model id (예: gpt-5.6-sol, claude-sonnet-4-6, deepseek-v4-pro).
1단계 — Models 열기
- Settings를 엽니다.
- 왼쪽에서 Models를 선택합니다.
- DeepSeek 카드의 Edit는 공식 키입니다. 누르지 마세요.

| 버튼 | 용도 |
|---|---|
| + Add provider | 카탈로그(Anthropic, OpenAI 등) |
| + Add a custom provider | APIMaster (이것) |
2단계 — 사용자 지정 프로바이더 입력
| 필드 | 값 |
|---|---|
| Provider ID | apimaster (소문자, 저장 후 이름 변경 불가) |
| Display name | apimaster 또는 APIMaster.ai |
| Base URL | https://apimaster.ai/v1 (/v1 필수) |
| API protocol | openai-completions |
| API key | APIMaster 키 |
모델을 최소 하나 추가하세요. 왼쪽은 요청 model id, 오른쪽은 표시 이름입니다. 예: gpt-5.6-sol. 또는 Fetch available models. Create provider를 클릭합니다.

목록에 없는 id는 로컬에서 UNKNOWN_MODEL로 실패합니다. /v1을 빼면 연결이 실패합니다.
3단계 — 저장 확인
DeepSeek와 회색 Custom 배지의 apimaster가 함께 보여야 합니다.

4단계 — 채팅에서 모델 선택
입력창 오른쪽 모델 이름을 클릭하고 apimaster 그룹에서 선택하세요. DeepSeek 그룹이 아닙니다.

5단계 — 테스트
hi를 보냅니다. 정상 응답과 LLM / TTFT / tok 지표가 보이면 성공입니다.

문제 해결
| 증상 | 해결 |
|---|---|
| 폼을 찾을 수 없음 | Settings → Models → + Add a custom provider |
401 / MISSING_CREDENTIAL |
Edit에서 키를 다시 붙여넣기 |
| 연결 실패 | https://apimaster.ai/v1 |
UNKNOWN_MODEL |
Models 목록에 id 추가 |
| 공식 DeepSeek로 나감 | apimaster 그룹에서 선택 |
| Provider ID 오류 | 새로 만들고 기존 항목 Delete |
체크리스트
-
npx @deepseek-ai/dsh web실행 - + Add a custom provider 사용
- API protocol =
openai-completions - Base URL =
https://apimaster.ai/v1 - apimaster 그룹 모델이 응답함