클라이언트/opencode
opencode에서 Wokey API 사용하기
Wokey API 키를 발급받고 opencode의 Base URL을 Wokey로 지정한 뒤 curl 요청 한 번으로 연결을 확인하세요.
업데이트
API 키와 Base URL 준비link
모든 클라이언트는 같은 Wokey API 키와 같은 Base URL을 사용합니다.
Wokey Base URL 사용
클라이언트의 Base URL에 게이트웨이 도메인을 입력하세요. /v1을 붙일지는 아래 설정을 참고하세요.
클라이언트 설정link
명령 하나로 Wokey 공급자를 작성하고 기본 모델을 wokey/auto로 전환합니다.
export WOKEY_API_KEY="YOUR_API_KEY"
curl -fsSL https://wokey.ai/downloads/opencode/install.sh | sh
opencodeAPI 형식과 Base URLlink
같은 클라이언트라도 API 형식을 바꾸면 Base URL 끝에 /v1을 붙일지가 달라질 수 있습니다.
| 형식 | Base URL | 용도 |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi 등 기타 모델 |
설정 위치: ~/.config/opencode/opencode.json
curl로 확인link
클라이언트에서 오류가 나면 먼저 curl로 API 키와 Base URL 문제가 아닌지 확인하세요.
opencode는 기본적으로 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
- 설치 스크립트는 무엇을 변경하나요?
- ~/.config/opencode/opencode.json에 wokey라는 공급자를 추가하고 기본 모델을 wokey/auto로 설정합니다. 기존 파일은 먼저 opencode.json.bak으로 백업되며, 그 안의 다른 공급자는 그대로 유지됩니다.
- API 키를 명령에 넣지 않을 수 있나요?
- WOKEY_API_KEY를 설정하지 않고 스크립트를 실행하면 터미널에서 입력 내용을 표시하지 않고 키를 묻습니다. 키는 opencode.json에 저장되므로 이 파일을 공유하지 마세요.
- 특정 모델을 사용하려면 어떻게 하나요?
- 스크립트를 실행하기 전에 WOKEY_MODEL을 설정하세요. 예를 들어 export WOKEY_MODEL=claude-opus-5-5로 설정하면 기본 모델이 wokey/claude-opus-5-5가 됩니다. 설정하지 않으면 auto를 사용합니다.