설정할 내용
Cursor는 사용자 정의 모델 제공자를 지원하는 편집기입니다. OpenAI 스타일의 베이스 URL, 키 및 모델 이름을 제공하면 기본 제공업체 대신 해당 위치에 채팅 요청을 보냅니다. 이 서비스는 Bearer 인증을 사용한 POST /v1/chat/completions 및 GET /v1/models을 지원합니다.
두 가지 명확히 할 사항이 있습니다. 이것은 OpenAI의 Codex가 아니며 Cursor의 공식 제품이 아닌 단일 오픈 웨이트 모델을 실행하는 독립적인 API입니다. 그리고 Cursor는 설정 화면을 자주 변경하므로 아래 레이블이 귀하의 버전에서 약간 다른 위치에 있을 수 있습니다. 세 가지 값은 변경되지 않습니다: 베이스 URL, 키, 모델 이름.
1단계: 키를 얻고 Cursor 외부에서 테스트
Google 또는 이메일과 비밀번호로 API 키 페이지에 가입하세요. 신규 계정은 한 번의 클릭으로 7일 유효한 $0.50 무료 체험 크레딧을 받을 수 있으며 카드가 필요하지 않습니다. 편집기 설정을 테스트하기에 충분합니다.
Cursor를 만지기 전에 키가 작동하는지 확인하세요. 편집기 내 오류는 터미널의 오류보다 읽기 어렵습니다.
curl https://api.getcodexapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
}'코드와 함께 JSON 응답을 받으면 계속 진행하세요. 오류가 발생하면 먼저 수정하세요. 일반적인 원인은 키의 누락된 문자나 끝에 붙여넣은 공백입니다.
2단계: Cursor 구성
- Cursor 설정을 열고 모델 섹션으로 이동하세요.
- OpenAI API 키 필드를 찾아 이 서비스에서 키를 붙여넣으세요.
- OpenAI 베이스 URL 덮어쓰기 옵션을 켜고
https://api.getcodexapi.com/v1을 입력하세요. - 사용자 정의 모델을 추가하고 정확한 이름
uncensored을 입력하세요. - 검증 버튼이 있으면 실행한 다음 채팅 패널을 열고 모델 목록에서
uncensored을 선택하세요.
검증 단계에서 실패가 보고되면 순서대로 세 가지를 확인하세요: 베이스 URL이 /v1로 끝나고 그 뒤에 엔드포인트 경로가 없어야 하며, 키는 후행 공백 없이 붙여넣어야 하며, 모델 이름에는 대문자가 없어야 합니다. docs 페이지의 가이드에는 추가 클라이언트 예제와 함께 동일한 값이 나열되어 있습니다.
계획해야 할 한 가지 사항: 덮어쓰기는 설정이며 모델별 선택이 아니므로 Cursor의 다른 곳에서 자체 OpenAI 키를 사용하는 경우 먼저 덮어쓰기를 끄세요. 변경한 내용을 메모하세요.
저장한 후 채팅에서 간단한 코딩 질문을 모델에 물어보고 응답을 확인하세요. Cursor가 요청을 빌드하는 동안 첫 번째 응답이 느린 것은 정상입니다. 응답이 오면 연결된 것이며 다음 단계는 자체 저장소에서 실제 작업으로 시도하는 것입니다.
키를 통과할 것과 통과하지 않을 것
Cursor는 여러 기능을 혼합합니다. 채팅 및 인라인 편집 요청은 선택한 후 사용자 정의 모델을 사용할 가능성이 가장 높은 기능입니다. 탭 자동 완성과 같은 다른 기능은 역사적으로 Cursor가 자체적으로 실행하는 모델을 사용했으며 에이전트 스타일 기능은 Cursor가 도구를 처리하는 방식에 따라 달라질 수 있습니다. 신뢰하는 기능을 시도하고 잔액을 모니터링하는 것이 정직한 방법입니다.
이것은 쉽게 수행할 수 있습니다: 이 API의 모든 응답에는 X-Balance-USD 헤더가 포함되며 계정에서 잔액을 확인할 수 있습니다. 채팅 메시지를 보내고 잔액이 변경되지 않으면 해당 요청이 저희에게 전달되지 않았습니다.
이 엔드포인트에서는 함수 호출을 지원합니다(tools, tool_choice, 스트리밍 방식으로 tool_calls 및 결과로 role: "tool"). 이는 편집 에이전트에 필요한 기능입니다. 스트리밍은 stream: true를 사용하여 서버 전송 이벤트를 통해 작동합니다. 컨텍스트 창은 프롬프트와 완성 결과를 합쳐 토큰 100,000개이며, 큰 파일과 그 주변 코드가 하나의 요청에 들어갈 수 있습니다.
편집기에서 무검열 모델을 사용하는 이유
대부분의 코딩 작업은 거절 응답을 받지 않습니다. 거절 응답을 받는 경우, 이는 신중한 필터가 위험해 보일 수 있는 정당한 작업입니다: 자체 네트워크용 포트 스캐너 작성, 분석 중인 악성코드 샘플 구문 분석, 공격적인 언어가 포함된 테스트 데이터 생성, 성인용 역할극 또는 동반자 앱의 백엔드 구축, 콘텐츠 검열을 처리하는 코드 리팩토링 등. 이 모델은 합법적인 성인 사용에 대해 콘텐츠 거절 없이 응답하도록 조정되었습니다.
이 모델은 여전히 전문가용 코드 모델이 아닌 일반적인 오픈 웨이트 모델이며, 사용자의 코드베이스에서 특정 대안 모델보다 성능이 뛰어나다는 보장은 없습니다. 직접 작업을 실행해 보세요. 하나의 규칙은 고정되어 있습니다: 미성년자가 포함된 성 콘텐츠는 없으며, 이는 변경할 수 없습니다.
실제 비용
가격은 선불 크레딧 기준 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 편집기 트래픽은 모든 요청이 파일 컨텍스트를 다시 보내기 때문에 입력 중심입니다.
입력 토큰 8,000개와 출력 토큰 1,000개로 이루어진 하나의 요청은 입력에 대해 8,000 x $0.15 / 1,000,000 = $0.0012, 출력에 대해 1,000 x $0.50 / 1,000,000 = $0.0005가 발생하여 총 $0.0017입니다. 사용량이 많은 날에 이러한 요청을 150개 하면 150 x $0.0017 = $0.255, 약 26 센트입니다.
컨텍스트로 40,000 토큰을 보내고 1,500을 받는 요청은 $0.006 + $0.00075 = $0.00675가 듭니다. 충전은 $20부터 시작하며 크레딧은 만료되지 않으므로, 다 쓰지 않아도 된다는 압박이 없습니다. 보너스 티어는 가격 책정 페이지에서, 일반적인 개요는 코딩 API 페이지에서 확인하세요.
편집기 사용 속도 제한
전체 키는 동시 요청 8개 및 분당 300개 요청을 허용합니다. 체험 키는 동시 2개 및 분당 60개를 허용합니다. 한 사람이 한 편집기에서 입력하는 경우 거의 어느 한 쪽에도 도달하지 않지만, 하나의 키를 공유하는 팀이나 병렬로 많은 요청을 보내는 에이전트의 경우 도달할 수 있습니다. 초과 시 API는 HTTP 429를 반환합니다. 코드 rate_limited은 분당 요청이 너무 많음을 의미하며, concurrency은 동시에 너무 많음을 의미합니다. 서비스에 일시적으로 과부하가 걸리면 Retry-After: 5와 함께 429도 표시됩니다.
스트리밍된 채팅은 스트림이 끝날 때까지 동시성 슬롯을 유지합니다. 공유 사용의 경우 팀에 하나의 키 대신 각 개발자에게 자체 키를 제공하세요.
문제 해결 체크리스트
- 모델을 찾을 수 없음. 공백 없이
uncensored를 다시 입력하세요. 사용하지 않는 기존 사용자 정의 모델을 제거하세요. - 인증 오류. 키를 다시 복사하세요. Cursor가 여전히 다른 제공업체의 키를 사용하고 있지 않은지 확인하세요.
- 응답이 조기에 중단됨. Cursor가 자체 출력 한계를 설정하는지 확인하세요. 저희 쪽에서는
max_tokens이 선택 사항입니다. - 잔액에 변화가 없음. 사용한 기능이 사용자 정의 키로 라우팅되지 않았습니다. 대신 채팅을 시도하세요.
- 빈번한 429. 동시 요청을 줄이거나 체험 키 대신 전체 키를 사용하세요.
