WorkBuddy에서 Wokey API 사용하기

1. 1

   모델 설정 열기

   WorkBuddy 왼쪽 아래의 계정 버튼 → Settings → Model을 클릭하세요. 모델 선택기를 열고 Configure custom model을 선택해도 됩니다.

2. 2

   사용자 지정 모델 추가

   Custom을 선택하세요. 엔드포인트를 https://api.wokey.ai로 설정하고 Wokey API 키를 붙여 넣은 뒤 정확한 모델 ID deepseek-v4.1-flash를 입력하세요(이전 ID인 deepseek-flash도 사용할 수 있습니다).

3. 3

   기능 설정

   도구 호출과 이미지 입력을 켜세요. 추론 모드와 사용자 지정 프로토콜은 끈 상태로 두세요. deepseek-v4.1-flash는 텍스트, 이미지, 도구를 지원합니다. 대신 deepseek-v4-flash를 사용한다면 해당 모델은 텍스트 전용이므로 이미지 입력을 끄세요.

4. 4

   저장 후 모델 전환

   Test connection을 실행하고 모델을 저장한 뒤 대화의 모델 선택기에서 선택하세요. 도구나 이미지를 테스트하기 전에 짧은 텍스트 프롬프트로 먼저 확인하세요.

Provider: Custom
Endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model: deepseek-v4.1-flash
Tool calling: On
Image input: On
Reasoning mode: Off
Custom protocol: Off

설정 위치: Settings → Models → Custom models

• 404: 엔드포인트는 https://api.wokey.ai로 두고 사용자 지정 프로토콜은 끄세요. 사용자 지정 프로토콜을 켠 경우에만 전체 https://api.wokey.ai/v1/chat/completions 경로를 입력해야 합니다.
• 401: API 키 필드에는 키 자체를 붙여 넣고 Bearer 접두사는 붙이지 마세요. 키가 활성 상태이고 계정에 잔액이 있는지 확인하세요.
• model_not_found: 모델 ID를 공백이나 추가 접미사 없이 deepseek-v4.1-flash로 설정하세요.
• 이미지 요청 실패: deepseek-v4.1-flash를 선택하고 이미지 입력을 켜세요. deepseek-v4-flash는 텍스트만 받습니다.
• 429, 502, 504, 529: 동시 실행 수를 줄이거나, 컨텍스트를 줄이거나, 잠시 후 다시 시도하세요. 사용 가능한 다른 모델로 전환할 수도 있습니다.

WorkBuddy는 기본적으로 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" }
    ]
  }'

WorkBuddy의 API 주소는 /v1로 끝나야 하나요?

아니요. https://api.wokey.ai를 사용하고 사용자 지정 프로토콜 스위치는 끈 상태로 두세요. 사용자 지정 프로토콜을 켠 경우에만 전체 주소 https://api.wokey.ai/v1/chat/completions를 입력합니다. 둘이 맞지 않으면 404가 반환됩니다.

모델 이름에는 무엇을 넣나요?

정확한 모델 ID(예: deepseek-v4.1-flash)를 공백이나 접미사 없이 입력합니다. 그 외에는 model_not_found가 반환됩니다.

이미지 요청이 실패하는 이유는 무엇인가요?

모델이 deepseek-v4.1-flash이고 이미지 입력 스위치가 켜져 있는지 확인하세요. deepseek-v4-flash는 텍스트 모델이므로 사용할 때 이미지 입력을 끄세요.