Cherry Studio에서 Wokey API 사용하기

1. 1

   공급자 추가

   Settings → Model Provider를 열고 목록 아래쪽의 + Add Provider를 클릭한 뒤 Provider Name을 Wokey로 설정하세요. 이전 버전에서는 공급자 유형도 묻는데, OpenAI를 선택하세요.

2. 2

   주소와 키 입력

   엔드포인트 설정에서 OpenAI를 /v1 없는 https://api.wokey.ai로 설정하고 Wokey API 키를 붙여 넣은 뒤 Add를 클릭하세요. 필드 아래에 최종 요청 경로 미리보기가 표시됩니다.

3. 3

   모델 추가

   Sync models를 클릭해 모델 목록을 가져오거나, 옆의 +를 클릭해 모델 ID를 직접 입력하세요. 예: claude-opus-5-5.

4. 4

   확인 후 사용

   API 키 오른쪽의 Model Check를 클릭하고, 공급자 페이지 오른쪽 위의 활성화 스위치가 켜져 있는지 확인하세요. 그런 다음 채팅 창 위쪽의 Wokey 아래에서 모델을 고르세요.

Provider name: Wokey
OpenAI endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model ID: claude-opus-5-5

설정 위치: Settings → Model Provider → Add Provider

Cherry Studio는 기본적으로 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": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

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

아니요. https://api.wokey.ai를 사용하세요. Cherry Studio가 /v1/chat/completions를 직접 붙이고 입력란 아래에 최종 요청 경로 미리보기를 보여 주므로 저장하기 전에 확인할 수 있습니다.

OpenAI와 Anthropic 중 어느 엔드포인트를 입력하나요?

Chat Completions로 모델을 호출하려면 OpenAI 엔드포인트만으로 충분합니다. Claude 모델을 네이티브 Anthropic Messages 형식으로 보내려면 같은 공급자의 Anthropic 엔드포인트도 https://api.wokey.ai로 설정하세요. 이전 버전에는 엔드포인트 설정 대신 공급자 유형이 있으니 OpenAI를 선택하세요.

모델 목록이 비어 있는 이유는 무엇인가요?

새 공급자에는 처음에 모델이 없습니다. Sync models를 클릭해 Wokey에서 목록을 가져오거나, 옆의 +를 클릭해 모델 ID(예: claude-opus-5-5)를 직접 입력하세요.

Model Check에서 401이 반환되면 어떻게 하나요?

API 키 입력란에는 Bearer 접두사, 공백, 줄바꿈 없이 키만 붙여 넣으세요. 그런 다음 키가 삭제되거나 일시 중지되지 않았는지, 계정에 잔액이 있는지 확인하세요.