Cursor AI API 키: 커스텀 키를 넣는 곳

짧은 답변

Cursor 계열 편집기는 커스텀 제공업체와 통신하기 위해 세 가지 값이 필요합니다: 기본 URL, API 키 및 모델 이름. 이 서비스의 경우 다음과 같습니다:

• Base URL: https://api.cursoraiapikey.com/v1
• API 키: API 키 페이지의 키
• 모델 이름: uncensored

편집기 설정을 열고 모델 섹션을 찾습니다. Cursor는 OpenAI API 키 필드와 OpenAI 기본 URL 재정의 옵션을 제공하지만 버전마다 메뉴 레이블이 이동하므로 찾을 수 없으면 설정에서 "base URL"을 검색하세요. URL과 키를 붙여넣고, uncensored라는 커스텀 모델을 추가한 후 버전에서 확인 버튼을 지원한다면 사용하세요.

이 서비스는 Cursor와 독립적입니다. 별도의 호스팅 API이며 편집기의 자체 계정이나 플랜을 대체하지 않습니다. 편집기의 채팅을 다른 OpenAI 호환 서버로 연결하는 것입니다.

두 가지 키와 두 가지 위치

사람들은 관련 없는 두 가지 개념에 같은 단어를 사용하며, 이를 혼동하는 것이 설정 실패의 가장 흔한 이유입니다.

계정 로그인

편집기에는 자체 로그인이 있습니다. 이는 편집기 벤더에게 사용자를 식별하는 용도이며 모델 제공업체와는 무관합니다. 제공업체 키를 로그인 화면에 붙여넣지 마세요.

제공업체 키

모델을 운영하는 회사에서 발급한 비밀 문자열입니다. Base URL과 함께 모델 설정에 붙여넣으면 편집기는 모든 요청에 Authorization: Bearer 헤더를 포함하여 전송합니다. 이 서비스의 키는 이 서비스의 Base URL에서만 작동하며, 다른 제공업체의 키는 여기서 작동하지 않습니다.

편집기의 자체 키를 무료로 얻는 방법을 찾고 여기로 왔다면, 이것이 아닙니다. 편집기 채팅 패널 뒤에 저렴한 텍스트 모델을 사용하려면 계속 읽으세요. 이 패턴은 OpenAI 호환 엔드포인트를 받는 모든 편집기에 적용되며, Claude 키 교체에 대한 기사는 Anthropic 스타일 설정에 대한 유사한 경우를 다룹니다.

편집기 수정 전 엔드포인트 테스트

편집기 외부에서 2분 테스트를 하면 문제가 키에 있는지 편집기인지 알 수 있습니다. 계정을 생성하고 키 페이지에서 체험을 청구한 후 다음을 실행하세요:

Copycurl https://api.cursoraiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the word ok."}]
  }'

choices 배열이 있는 JSON 바디를 받아야 합니다. 응답 헤더에는 X-Balance-USD가 포함되어 크레딧의 남은 잔액을 보여줍니다. 공식 SDK를 사용한 Python 호출:

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.cursoraiapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)

두 호출이 모두 작동하면 키에 문제가 없으며, 이후의 오류는 편집기 설정에서 비롯됩니다.

편집기 내 단계별 설정

1. Google 또는 이메일과 비밀번호로 가입한 후 API 키 페이지에서 $0.50 체험 크레딧을 청구하세요. 카드가 필요 없으며 7일 동안 유효합니다.
2. 키를 복사합니다. 비밀번호처럼 취급하세요.
3. 편집기에서 설정을 열고 Models 섹션으로 이동합니다. 버전마다 이름이 다르므로 이 목록의 레이블을 가이드로 사용하세요.
4. OpenAI API 키 필드에 키를 붙여넣으세요.
5. OpenAI Base URL 재정의 옵션을 켜고 https://api.cursoraiapikey.com/v1를 입력하세요. /v1을 유지하고 /chat/completions을 추가하지 마세요. 클라이언트가 나머지를 추가합니다.
6. 정확한 이름 uncensored으로 커스텀 모델을 추가하세요.
7. 채팅 패널에서 해당 모델을 선택하고 짧은 메시지를 보내세요.

버전에서 확인 단계를 실행하고 curl은 작동하는데 확인이 실패하면 키 끝에 공백이 남아 있지 않은지, Base URL 끝에 두 번째 /v1가 없는지 확인하세요.

키 사용 범위

커스텀 엔드포인트 설정이 모든 기능을 변경하는 것은 아닙니다. 편집기는 종종 인라인 완성 또는 diff 적용과 같은 일부 기능을 벤더가 자체적으로 호스팅하는 모델에서 실행하며, 이러한 기능은 키를 무시할 수 있습니다. 채팅 및 에이전트 스타일 요청이 일반적으로 구성한 엔드포인트로 전송됩니다. 편집기의 문서가 사용자의 버전 기준이므로 특정 기능에 대해 계획하기 전에 확인하세요.

확인할 가치가 있는 다른 두 가지 사항:

• 요청 경로. 버전별로 요청이 엔드포인트에 도달하기 전에 편집자의 벤더가 운영하는 서버를 거칠 수 있습니다. 이 경우 로컬 기본 URL은 작동하지 않지만 이 같은 공개 URL은 작동합니다. 편집자가 어떤 데이터를 저장하는지 확인하려면 개인정보 보호 안내를 읽으세요.
• 모델 범위. 이 서비스는 합법적인 성인 사용에 콘텐츠 거부 없이 답변하도록 튜닝된 하나의 오픈 웨이트 모델을 실행합니다. 텍스트 전용입니다. 이미지, 오디오 또는 임베딩을 생성하지 않으므로 이러한 기능이 필요한 기능은 이를 통해 작동하지 않습니다.

컨텍스트 창은 프롬프트와 완성의 합계로 100,000 토큰이며, 대부분의 단일 파일 작업과 많은 다중 파일 작업에 충분합니다. 매우 큰 저장소 덤프는 들어가지 않습니다.

일반적인 오류 해결

증상	잠재적 원인	해결 방법
401 Unauthorized	잘못되거나 취소된 키, 추가 공백, 잘못된 필드에 키 붙여넣기	키 페이지에서 키를 재생성하고 다시 붙여넣으세요. 이전 키는 즉시 작동하지 않습니다.
404 Not Found	기본 URL에 /v1 누락 또는 /v1/v1 중복	정확히 https://api.cursoraiapikey.com/v1를 사용하세요.
모델을 찾을 수 없음	서로 다르게 입력된 사용자 지정 모델 이름	이름은 uncensored이며 모두 소문자입니다.
concurrency 관련 429	동시 요청이 너무 많습니다. 체험 키는 2개를 허용합니다.	실행 중인 요청이 완료되기를 기다리거나, 동시 요청을 최대 8개 허용하는 전체 키로 전환하세요.
rate_limited과 함께 429	분당 제한을 초과했습니다. 체험 키는 분당 60개, 풀 키는 분당 300개	속도를 줄이세요. 에이전트 루프는 급증할 수 있습니다.
Retry-After: 5과 함께 429	일시적 과부하	5초 후 다시 시도하세요.

에이전트 모드는 여러 요청을 동시에 보낼 수 있으며, 스트리밍 응답은 스트리밍이 끝날 때까지 슬롯을 유지합니다. 동시성 제한에 쉽게 도달하기 쉬운 체험 키의 경우입니다. 이는 정상적인 동작이며 키의 결함이 아닙니다.

요청 비용

선불 크레딧을 기반으로 한 종량제 과금으로, 입력 토큰 100만 토큰당 $0.15, 출력 토큰 100만 토큰당 $0.50입니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다. 편집기에서 일반적인 채팅 한 턴을 수행할 때 열린 파일과 일부 이력을 보내고(예: 입력 토큰 20,000개), 출력 토큰 1,500개를 받습니다:

• 입력: 20,000 x $0.15 / 1,000,000 = $0.0030
• 출력: 1,500 x $0.50 / 1,000,000 = $0.00075
• 총: $0.00375, 0.5센트 미만

따라서 $0.50 체험 크레딧은 해당 크기의 약 133턴을 커버합니다. 이는 오후의 실제 테스트에 충분합니다. 계속 진행하기로 결정하면 충전은 $20부터 $500까지 전체 금액으로 가능하며, $50부터 5%, $100부터 10%, $200부터 15%의 보너스가 제공됩니다. 암호화폐(USDT on TRC20 또는 USDC on Base)로 결제됩니다. 크레딧은 만료되지 않습니다. 가격 페이지에는 전체 표가 있으며, 문서에는 지원되는 모든 매개변수가 나열되어 있습니다.

더 많은 가이드

• Cursor AI 가격 vs API: 구독 또는 토큰 단위
• 무검열 사용을 위한 Claude API 키 대체재