pi에서 Wokey API 사용하기

1. 1

   API 키 export

   pi를 실행할 터미널에서 export WOKEY_API_KEY="YOUR_API_KEY"를 실행하거나 ~/.zshrc에 추가하세요.

2. 2

   models.json 작성

   아래 내용을 ~/.pi/agent/models.json에 저장하세요. 파일에 이미 다른 공급자가 있다면 providers 아래에 wokey 항목만 추가하세요.

3. 3

   모델 선택

   pi를 시작하고 /model을 입력한 뒤 wokey 아래의 모델을 고르세요.

{
  "providers": {
    "wokey": {
      "baseUrl": "https://api.wokey.ai",
      "api": "anthropic-messages",
      "apiKey": "$WOKEY_API_KEY",
      "models": [
        { "id": "claude-opus-5-5", "reasoning": true, "input": ["text", "image"] }
      ]
    }
  }
}

설정 위치: ~/.pi/agent/models.json

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

curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

pi의 baseUrl은 /v1로 끝나야 하나요?

api 필드에 따라 다릅니다. anthropic-messages이면 /v1 없이 https://api.wokey.ai를, openai-completions 또는 openai-responses이면 https://api.wokey.ai/v1을 사용하세요.

/model에 Wokey 모델이 보이지 않는 이유는 무엇인가요?

pi는 API 키를 확인할 수 없으면 사용자 지정 모델을 표시하지 않습니다. apiKey가 $WOKEY_API_KEY라면 pi를 시작하는 같은 터미널에서 export WOKEY_API_KEY를 실행한 뒤 models.json이 올바른 JSON인지 확인하세요. /model은 열 때마다 이 파일을 다시 읽습니다.

pi에서 Wokey 모델에 이미지를 보내려면 어떻게 하나요?

pi의 사용자 지정 모델은 기본적으로 텍스트 입력만 선언합니다. 이미지를 지원하는 모델에 "input": ["text", "image"]를 추가해 이미지 입력을 받는다고 선언하세요.

컨텍스트 윈도우와 최대 출력을 바꿔야 하나요?

지정하지 않으면 pi는 contextWindow 128000, maxTokens 16384로 간주합니다. 모델의 윈도우가 더 크면 모델 항목의 contextWindow와 maxTokens를 모델 페이지의 값으로 설정하세요.

API 키를 파일에 넣지 않을 수 있나요?

네. apiKey는 $NAME 형식의 환경 변수와, 명령 출력에서 키를 읽는 !command 형식을 지원합니다.