DeepSeek Harness에서 Wokey API 사용하기

1. 1

   0.2.1 프리릴리스 설치

   npm의 latest 태그는 아직 0.2.0입니다. DeepSeek은 V4.1-Flash-1017에 v0.2.1-rc.1 이상을 권장하므로 @next를 설치하세요.

2. 2

   API 키 변수 설정

   설정에는 apiKeyEnv 이름만 적으므로 키가 파일에 남지 않습니다. 웹 UI의 Settings → Models에서 키를 저장할 수도 있습니다.

3. 3

   공급자 추가

   ~/.dsh/profiles/web/cordis.patch.yml을 편집하세요(dsh headless는 profiles/headless). 이 예시는 두 모델 모두 Anthropic Messages를 사용하며 Base URL은 https://api.wokey.ai입니다. 대신 OpenAI Chat Completions를 선택한다면 별도의 공급자를 만들고 https://api.wokey.ai/v1을 사용하세요.

4. 4

   이미지 입력 선언

   DeepSeek Harness는 선언되지 않은 사용자 지정 모델을 텍스트 전용으로 취급하므로, Wokey 모델이 비전을 지원하더라도 요청이 Wokey에 도달하기 전에 이미지를 거부할 수 있습니다. Opus 5.5, Haiku 5.5 등 비전 모델은 해당 모델 아래에 input: [text, image]를 추가하세요. UI에서는 Settings → Models → 공급자 편집 → Customized settings → 모델 행 펼치기 → Input types → Image를 사용하세요. 저장한 뒤 새 세션을 시작하세요.

5. 5

   기존 공급자 유지

   이 재정의는 llm-pi-ai 항목 설정 전체를 대체하므로, UI에서 이미 공급자를 추가했다면 그것들도 providers 아래에 나열하세요. 모든 들여쓰기는 공백을 사용하고 YAML에 탭을 섞지 마세요. 저장한 뒤 새 세션을 시작하세요.

# 1. 0.2.1 설치 또는 업데이트
npm install -g @deepseek-ai/dsh@next
export WOKEY_API_KEY="YOUR_API_KEY"

# 2. ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-pi-ai
  config:
    providers:
      wokey:
        displayName: Wokey
        apiKeyEnv: WOKEY_API_KEY
        api: anthropic-messages
        baseURL: https://api.wokey.ai
        models:
          - id: claude-opus-5-5
            name: Claude Opus 5.5
            contextWindow: 1000000
            input: [text, image]
          - id: deepseek-v4.1-flash
            name: DeepSeek-V4.1-Flash
            contextWindow: 1000000
            maxTokens: 393216
            input: [text, image]
- id: agent-default-model
  config:
    provider: wokey
    model: claude-opus-5-5

# 3. 시작
dsh web

설정 위치: ~/.dsh/profiles/web/cordis.patch.yml

Wokey는 이 페이지에 나열된 모델 추론 인터페이스를 제공하며, 단독 /v1/tools/search 또는 /v1/tools/fetch 엔드포인트는 제공하지 않습니다. 도구 호출을 지원한다고 해서 upstream의 모든 내장 웹 도구를 지원하는 것은 아닙니다. 모델 요청 안의 서버 측 검색은 실제 공급 경로에 따라 달라지며, 현재 Wokey가 검증하고 일관되게 지원하는 기능으로 표시하지 않습니다. 이 페이지는 Search/Fetch 호출당 Wokey 가격도 공개하지 않습니다. 문서로 지원되는 단독 검색·Fetch가 필요하면 DeepSeek API 키로 api.deepseek.com을 사용하고, Wokey 모델 호출과 별도로 설정·과금하세요.

• “The current model does not support images”: Harness의 로컬 기능 검사 때문이며, Wokey나 Opus 5.5가 비전을 지원하지 않는다는 뜻이 아닙니다. 해당 모델에서 Image를 켜거나 YAML 항목에 input: [text, image]를 추가하세요.
• 저장 후에도 이미지가 거부됨: 새 세션을 시작하고 모델을 다시 선택하세요. 기존 세션은 기록된 모델 기능과 첨부 파일을 그대로 유지합니다.
• 이미지 요청이 400을 반환함: 프로토콜과 Base URL을 맞추세요. Anthropic Messages는 /v1 없는 https://api.wokey.ai를, OpenAI Chat Completions는 https://api.wokey.ai/v1을 사용합니다. deepseek-v4.1-flash는 두 형식을 모두 지원하지만, 클라이언트는 선택한 프로토콜의 형식으로 보내야 합니다.
• 앱이 시작되지 않거나 YAML 줄 번호를 보고함: input이 의도한 모델 아래에 중첩되어 있는지, 모든 모델의 대시가 정렬되어 있는지, 파일에 탭이 없는지 확인하세요. 백업을 복원한 뒤 공백만 사용해 다시 저장하세요.
• 앱이 “Select a model” 상태로 시작됨: agent-default-model이 여전히 존재하는 공급자와 모델을 가리키는지 확인하세요. 공급자를 삭제하거나 이름을 바꾼 뒤에는 이것도 업데이트하세요.
• 탐색 후 모델은 보이지만 이미지 기능이 없음: Fetch available models는 주로 ID와 용량 필드만 채웁니다. 모든 모델을 비전 지원으로 표시하지 말고, 사용자 지정 비전 모델마다 input: [text, image]를 명시적으로 선언하세요.
• 저장 후 다른 공급자가 사라짐: cordis.patch.yml 재정의는 llm-pi-ai 항목 전체를 대체하므로 기존 공급자를 모두 providers 아래에 유지하세요.

DeepSeek Harness는 기본적으로 OpenAI Chat Completions 형식을 사용합니다. 이 요청이 200을 반환하면 API 키와 Base URL이 올바른 것입니다. 보내기 전에 YOUR_API_KEY를 내 키로 바꾸세요.

curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

DeepSeek Harness의 baseURL은 /v1로 끝나야 하나요?

provider의 api 필드에 따라 다릅니다. anthropic-messages이면 /v1 없이 https://api.wokey.ai를 사용하고, OpenAI Chat Completions에는 https://api.wokey.ai/v1을 사용하는 별도의 provider가 필요합니다.

현재 모델이 이미지를 지원하지 않는다고 나오는 이유는 무엇인가요?

Harness의 로컬 기능 검사 때문입니다. 사용자 지정 모델은 기본적으로 텍스트 입력만 선언합니다. 모델 항목에 input: [text, image]를 추가하고 저장한 뒤 새 세션에서 다시 시도하세요.

저장한 후 다른 provider가 사라진 이유는 무엇인가요?

cordis.patch.yml의 llm-pi-ai 재정의는 항목 전체를 대체합니다. 기존에 있던 provider도 Wokey와 함께 providers에 적어 넣으세요.