클라이언트/Codex

Codex에서 Wokey API 사용하기

Wokey API 키를 발급받고 Codex의 Base URL을 Wokey로 지정한 뒤 curl 요청 한 번으로 연결을 확인하세요.

업데이트

이 페이지 내용expand_more

API 키와 Base URL 준비link

모든 클라이언트는 같은 Wokey API 키와 같은 Base URL을 사용합니다.

API 키 만들기

로그인한 뒤 API 페이지에서 플랫폼 키를 만드세요. 같은 계정의 키는 잔액을 공유합니다.

API 키 만들기key

Wokey Base URL 사용

클라이언트의 Base URL에 게이트웨이 도메인을 입력하세요. /v1을 붙일지는 아래 설정을 참고하세요.

클라이언트 설정link

Codex CLI와 Codex 데스크톱 앱은 같은 설정을 공유하므로 아래 설정이 둘 다에 적용됩니다. Codex는 Responses 프로토콜을 사용합니다. base_url은 /responses 없이 게이트웨이 오리진으로 두세요. experimental_bearer_token의 YOUR_API_KEY를 Wokey API 키로 바꾸고, Bearer 접두사는 붙이지 마세요. 기존 env_key 설정은 삭제하세요. 환경 변수를 export할 필요는 없습니다. 파일을 저장하고 codex를 실행하세요. 키는 로컬 설정 파일에 평문으로 저장됩니다.

Codex
# ~/.codex/config.toml
model = "gpt-6-sol"
model_provider = "wokey"

[model_providers.wokey]
name = "Wokey"
base_url = "https://api.wokey.ai"
experimental_bearer_token = "YOUR_API_KEY"
wire_api = "responses"

# shell
codex

API 형식과 Base URLlink

같은 클라이언트라도 API 형식을 바꾸면 Base URL 끝에 /v1을 붙일지가 달라질 수 있습니다.

형식Base URL용도
OpenAI Responseshttps://api.wokey.aiGPT 모델

설정 위치: ~/.codex/config.toml

curl로 확인link

클라이언트에서 오류가 나면 먼저 curl로 API 키와 Base URL 문제가 아닌지 확인하세요.

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

cURL
curl https://api.wokey.ai/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "instructions": "You are a helpful assistant.",
    "input": [
      { "role": "user", "content": "Hello" }
    ],
    "store": false,
    "stream": false
  }'

오류 및 문제 해결link

먼저 인증, 잔액, 속도 제한, 모델 사용 가능 여부, 업스트림 타임아웃 중 어느 경우인지 구분하세요.

401

invalid api key

키가 없거나, 잘못 입력되었거나, 삭제되었거나, Authorization과 x-api-key 헤더가 서로 다릅니다.

402

insufficient balance

계정 잔액이 부족합니다. 요청을 더 보내기 전에 충전하세요.

403

model_denylisted / account_restricted

반복된 위반으로 해당 모델 또는 계정의 모든 모델에 대한 호출이 일시 중지되었습니다. 위반 처리 수수료 및 제한을 참고하세요.

403

request_blocked

이 요청은 업스트림에 도달하기 전에 차단되었으며 과금되지 않습니다. 예를 들어 모델이 방금 거부한 요청을 그대로 다시 보냈거나, 일시 중지된 최종 사용자(X-End-User-Id)인 경우입니다. 오류 메시지에 무엇이 차단되었는지 나와 있으니 안내에 따라 요청을 수정하거나 나중에 다시 시도하세요. 다른 요청에는 영향이 없습니다.

429

rate limited

요청이 너무 잦습니다. 나중에 다시 시도하거나 동시 실행 수를 줄이세요. 특정 모델 하나 또는 특정 최종 사용자(X-End-User-Id) 하나만 계속 429를 반환한다면 위반 후의 일시적인 제한일 수 있습니다.

499

client disconnected

응답이 끝나기 전에 클라이언트가 연결을 닫았습니다(코드 downstream_aborted). 기본적으로 무료입니다. 계정에서 지난 24시간 동안 클라이언트 연결 끊김이 50회 이상 발생하고 그것이 요청의 10% 이상을 차지하면, 이후 연결이 끊긴 요청은 업스트림이 보고한 사용량으로 과금됩니다. 대상은 캐시 읽기와 쓰기를 포함한 처리된 입력, 그리고 업스트림이 집계한 경우에만 출력입니다. 업스트림이 사용량을 보고하기 전에 끊긴 경우는 계속 무료입니다. 과금이 시작되면 계정에 알림이 가며, 연결 끊김 비율이 정상으로 돌아오면 1시간 안에 과금이 자동으로 중지됩니다. 흔한 원인은 클라이언트나 프록시의 타임아웃이 너무 짧거나, 프로그램이 완료 전에 요청을 취소하는 경우입니다.

502

upstream unavailable

업스트림 모델 서비스를 일시적으로 사용할 수 없습니다. 모델을 바꾸거나 나중에 다시 시도하세요.

504

upstream timeout

업스트림 응답 시간이 초과되었습니다. 컨텍스트를 줄이거나 max_tokens를 낮추거나 다시 시도하세요.

529

upstream overloaded

업스트림 모델이 일시적으로 과부하 상태이며, Wokey는 이미 다른 경로로 재시도했습니다(코드 upstream_overloaded). 잔액과는 관계가 없습니다. 잠시 후 다시 시도하거나 모델을 바꾸세요.

자주 묻는 질문link

Codex의 base_url은 /v1이나 /responses로 끝나야 하나요?
둘 다 아닙니다. base_url을 https://api.wokey.ai로 설정하세요. Codex가 /responses를 직접 붙이므로 수동으로 추가하면 경로가 중복됩니다.
experimental_bearer_token에 Bearer라는 단어가 필요한가요?
아니요. Wokey API 키만 붙여 넣고 예전 env_key 줄을 삭제하세요. 그러면 환경 변수가 필요 없습니다.
wire_api에는 무엇을 넣나요?
responses입니다. Codex는 OpenAI Responses 형식을 사용하며, Wokey에서 GPT 모델은 이 형식으로 호출합니다.

설정 및 오류 가이드link