클라이언트/Magpie
Magpie에서 Wokey API 사용하기
Wokey API 키를 발급받고 Magpie의 Base URL을 Wokey로 지정한 뒤 curl 요청 한 번으로 연결을 확인하세요.
업데이트
API 키와 Base URL 준비link
모든 클라이언트는 같은 Wokey API 키와 같은 Base URL을 사용합니다.
Wokey Base URL 사용
클라이언트의 Base URL에 게이트웨이 도메인을 입력하세요. /v1을 붙일지는 아래 설정을 참고하세요.
클라이언트 설정link
Magpie는 내 컴퓨터에서 실행되는 모델 게이트웨이입니다. Wokey를 공급자로 추가하면 컴퓨터의 모든 에이전트가 Magpie를 통해 Wokey 모델을 호출할 수 있습니다. Magpie는 API 형식마다 주소를 하나씩 저장하며, 명령 하나로 세 가지를 모두 설정합니다.
- 1
공급자 추가
아래 magpie provider add 명령에서 YOUR_API_KEY를 Wokey API 키로 바꿔 실행하세요. url과 responses에는 https://api.wokey.ai/v1을, anthropic에는 /v1 없는 https://api.wokey.ai을 입력합니다. models 인수를 생략하면 Magpie가 Wokey에서 모델 목록을 읽어 옵니다.
- 2
또는 가져오기 링크 사용
Magpie 0.1.8 이상에서는 https://usemagpie.ai/import#name=Wokey&chat=https://api.wokey.ai/v1&anthropic=https://api.wokey.ai을 열고 대화 상자에 API 키를 붙여 넣은 뒤 확인하세요.
- 3
에이전트에서 모델 선택
모델은 wokey/모델-id 형식으로 입력하세요. 예: wokey/claude-opus-5-5.
magpie provider add "Wokey" \
url=https://api.wokey.ai/v1 \
responses=https://api.wokey.ai/v1 \
anthropic=https://api.wokey.ai \
key=YOUR_API_KEYAPI 형식과 Base URLlink
같은 클라이언트라도 API 형식을 바꾸면 Base URL 끝에 /v1을 붙일지가 달라질 수 있습니다.
| 형식 | Base URL | 용도 |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai/v1 | DeepSeek, GLM, Kimi 등 기타 모델 |
| OpenAI Responses | https://api.wokey.ai/v1 | GPT 모델 |
| Anthropic Messages | https://api.wokey.ai | Claude 모델 |
설정 위치: magpie provider add 또는 가져오기 링크(파일 ~/.config/magpie/providers.json)
curl로 확인link
클라이언트에서 오류가 나면 먼저 curl로 API 키와 Base URL 문제가 아닌지 확인하세요.
Magpie는 기본적으로 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": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'오류 및 문제 해결link
먼저 인증, 잔액, 속도 제한, 모델 사용 가능 여부, 업스트림 타임아웃 중 어느 경우인지 구분하세요.
invalid api key
키가 없거나, 잘못 입력되었거나, 삭제되었거나, Authorization과 x-api-key 헤더가 서로 다릅니다.
insufficient balance
계정 잔액이 부족합니다. 요청을 더 보내기 전에 충전하세요.
model_denylisted / account_restricted
반복된 위반으로 해당 모델 또는 계정의 모든 모델에 대한 호출이 일시 중지되었습니다. 위반 처리 수수료 및 제한을 참고하세요.
request_blocked
이 요청은 업스트림에 도달하기 전에 차단되었으며 과금되지 않습니다. 예를 들어 모델이 방금 거부한 요청을 그대로 다시 보냈거나, 일시 중지된 최종 사용자(X-End-User-Id)인 경우입니다. 오류 메시지에 무엇이 차단되었는지 나와 있으니 안내에 따라 요청을 수정하거나 나중에 다시 시도하세요. 다른 요청에는 영향이 없습니다.
rate limited
요청이 너무 잦습니다. 나중에 다시 시도하거나 동시 실행 수를 줄이세요. 특정 모델 하나 또는 특정 최종 사용자(X-End-User-Id) 하나만 계속 429를 반환한다면 위반 후의 일시적인 제한일 수 있습니다.
client disconnected
응답이 끝나기 전에 클라이언트가 연결을 닫았습니다(코드 downstream_aborted). 기본적으로 무료입니다. 계정에서 지난 24시간 동안 클라이언트 연결 끊김이 50회 이상 발생하고 그것이 요청의 10% 이상을 차지하면, 이후 연결이 끊긴 요청은 업스트림이 보고한 사용량으로 과금됩니다. 대상은 캐시 읽기와 쓰기를 포함한 처리된 입력, 그리고 업스트림이 집계한 경우에만 출력입니다. 업스트림이 사용량을 보고하기 전에 끊긴 경우는 계속 무료입니다. 과금이 시작되면 계정에 알림이 가며, 연결 끊김 비율이 정상으로 돌아오면 1시간 안에 과금이 자동으로 중지됩니다. 흔한 원인은 클라이언트나 프록시의 타임아웃이 너무 짧거나, 프로그램이 완료 전에 요청을 취소하는 경우입니다.
upstream unavailable
업스트림 모델 서비스를 일시적으로 사용할 수 없습니다. 모델을 바꾸거나 나중에 다시 시도하세요.
upstream timeout
업스트림 응답 시간이 초과되었습니다. 컨텍스트를 줄이거나 max_tokens를 낮추거나 다시 시도하세요.
upstream overloaded
업스트림 모델이 일시적으로 과부하 상태이며, Wokey는 이미 다른 경로로 재시도했습니다(코드 upstream_overloaded). 잔액과는 관계가 없습니다. 잠시 후 다시 시도하거나 모델을 바꾸세요.
자주 묻는 질문link
- Magpie의 Wokey 주소는 /v1로 끝나야 하나요?
- Magpie는 형식별로 주소를 따로 저장합니다. chat과 responses에는 https://api.wokey.ai/v1을, anthropic에는 /v1 없이 https://api.wokey.ai를 사용하세요. 주소는 https여야 합니다.
- 가져오기 링크를 열어도 아무 반응이 없으면 어떻게 하나요?
- 가져오기 링크는 Magpie 0.1.8 이상이 필요합니다. 먼저 업그레이드하거나, 대신 magpie provider add 명령으로 공급자를 추가하세요.
- 에이전트에서 모델 이름은 어떻게 쓰나요?
- 공급자 id/모델 이름 형식으로 씁니다. 이름이 Wokey인 공급자의 id는 wokey이므로 Claude Opus 5.5는 wokey/claude-opus-5-5가 됩니다.
- Wokey API 키는 어디에 입력하나요?
- 가져오기 대화상자에 키를 붙여 넣거나 magpie provider add에 key=로 전달하세요. Magpie는 키를 ~/.config/magpie/providers.json에 저장합니다.
- 키가 포함된 가져오기 링크를 공유해도 되나요?
- 공유하지 마세요. key 매개변수는 평문이라 링크를 가진 누구나 잔액을 사용할 수 있습니다. 공유하기 전에 key 매개변수를 제거하세요. 상대방은 가져오기 대화상자에서 자신의 키를 입력합니다.