KO ▾
API 키 받기

cursorapikey.com/가이드

Cursor API 키 작동 안 함: 커스텀 엔드포인트 해결법

Cursor API 키가 작동하지 않는 경우 원인은 거의 다음 네 가지 원인 중 하나입니다: 베이스 URL, 모델 이름, 키 자체, 또는 계정 제한. curl 명령어 하나만 실행하면 어떤 것인지 알 수 있습니다.

업데이트

빛나는 키가 삽입되고 옆에 렌치와 돋보기가 있는 추상적인 코드 편집기 패널
Cursor 대체제 선택을 나타내는 편집기, 서버, 터미널로 이어지는 경로를 가진 아이소메트릭 포크

주요 포인트

  • curl을 사용해 Cursor 외부에서 키를 먼저 테스트하세요; curl이 작동하면 문제가 Cursor 설정에 있습니다.
  • 베이스 URL은 https://api.cursorapikey.com/v1이어야 하며 모델 이름은 정확히 uncensored여야 합니다.
  • 401은 키 오류, 404는 URL 오류, 429는 속도 또는 동시성 제한, 모델 오류는 잘못된 모델 이름을 의미합니다.
  • Cursor 버전마다 메뉴 레이블이 변경되므로 정확한 문구보다는 필드의 목적에 맞춰야 합니다.

1단계: Cursor 외부에서 키 테스트

Cursor의 개입을 배제하세요. 일반 요청이 작동한다면 키와 계정에 문제가 없으며 편집기 설정에 문제가 있습니다. 일반 요청이 실패한다면 오류 본문에 문제 원인이 명시됩니다.

curl -i https://api.cursorapikey.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 ready."}]}'

-i 플래그는 상태 행과 헤더를 출력합니다. 200 상태와 choices 배열이 있으면 성공입니다. X-Balance-USD 헤더는 남은 크레딧을 보여주며, 인증 또는 결제 오류가 발생하면 이를 먼저 확인해야 합니다.

모델 목록을 조회하여 키를 확인할 수도 있으며, 이는 비용이 들지 않습니다:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

응답에는 모델 ID uncensored가 포함되어야 합니다.

2단계: Cursor 필드 설정

Cursor의 설정을 열고 모델 섹션을 찾습니다. 세 가지 값을 입력해야 하며, 그 중 하나라도 잘못되면 키가 손상된 것처럼 보이는 오류가 발생합니다.

  1. OpenAI API 키: 양 끝의 공백이나 줄 바꿈 없이 키를 붙여넣습니다.
  2. OpenAI Base URL 재정의: 재정을 켜고 https://api.cursorapikey.com/v1을 입력하세요. /v1은 유지하고 /chat/completions은 제거하세요.
  3. 커스텀 모델: uncensored라는 이름의 모델을 추가하고 활성화합니다. 사용하지 않는 모델을 비활성화하여 Cursor가 엔드포인트가 알 수 없는 모델을 선택하지 않도록 합니다.

저장한 후 버전에서 제공하는 경우 확인 옵션을 사용하고, 채팅 모델 드롭다운에서 uncensored를 선택하세요. 새로운 채팅 탭은 좋은 테스트 방법이며, 오래된 탭은 시작할 때 선택한 모델을 유지할 수 있습니다. Cursor API 사용 방법의 단계별 안내는 더 많은 컨텍스트와 함께 동일한 설정 방법을 보여줍니다.

오류와 해결 방법 일치시키기

표시되는 내용잠재적 원인해결 방법
401, "잘못된 키", "인증되지 않음"키 오타, 잘림 또는 취소됨키 페이지에서 다시 복사하고 끝부분 공백을 확인하세요.
404, "not found"잘못된 URL, /v1 누락 또는 경로 중복정확히 https://api.cursorapikey.com/v1를 사용하세요.
"model not found" 또는 유사한 오류모델 이름이 uncensored와 다름소문자로 해당 정확한 이름의 커스텀 모델을 추가하세요.
rate_limited과 함께 429분당 요청 수 제한 초과요청 속도를 줄이세요. 체험 키는 분당 60개, 전체 키는 분당 300개를 허용합니다
concurrency 관련 429너무 많은 동시 요청동시 에이전트 실행 줄이기; 체험판 2, 전체 키 8
Retry-After: 5 포함 429일시적 과부하5초간 대기 후 재시도
curl에서는 작동하지만 Cursor에서는 실패함설정 저장 안 됨, 잘못된 탭 모델 또는 커스텀 키를 사용하지 않는 기능다음 섹션 참조

실패하거나 거부된 요청은 요금이 부과되지 않으므로 디버깅 중 다시 시도해도 비용이 들지 않습니다.

curl은 작동하지만 Cursor는 여전히 실패하는 경우

가장 혼란스러운 경우이며, 몇 가지 흔한 오해가 있습니다.

잘못된 모델이 선택되었습니다. Cursor에는 자체 내장 모델 목록이 유지됩니다. 그중 하나가 선택되면 요청이 귀하의 엔드포인트로 전혀 전송되지 않습니다. 사용하는 채팅 또는 컴포저의 드롭다운에서 uncensored을 명시적으로 선택하세요.

모든 기능이 API 키를 사용하지는 않습니다. 인라인 자동 완성처럼 Cursor 자체 모델을 사용하는 기능은 추가한 키와 관계없이 해당 모델을 계속 사용할 수 있습니다. 커스텀 키는 모델을 선택할 수 있는 채팅 및 수정 모드에 적용됩니다. 릴리스마다 변경되므로 Cursor의 최신 문서를 확인하세요.

에이전트 모드의 동시성 제한. 에이전트 및 다단계 실행은 여러 요청을 동시에 보낼 수 있습니다. 체험판 키는 동시에 두 개까지 허용합니다. 에이전트 모드에서만 오류가 발생하면 concurrency 제한에 도달한 것일 수 있으며, 전체 키는 이를 8까지 높여줍니다. 스트리밍 요청은 스트림이 끝날 때까지 슬롯을 점유하므로 긴 출력은 슬롯을 더 오래 차지합니다.

도구 호출. API는 도구 호출을 지원하며, tool_calls은 스트리밍되고 결과는 role: "tool"로 반환됩니다. 도구 사용의 품질은 모델에 따라 다르므로 에이전트 실행이 도구 단계에서 멈추면 먼저 일반 채팅에서 동일한 작업을 시도하세요.

계정 측면 확인

curl에서 잔액 관련 오류가 반환되면 키는 유효하지만 크레딧이 비었거나 무료 체험 기간이 종료되었습니다. 무료 체험 크레딧은 $0.50이며 7일 동안 유효하고, 가입 후 API 키 페이지에서 한 번의 클릭으로 청구할 수 있습니다. 이후에는 크레딧을 충전해야 합니다.

충전 금액은 $20부터 $500까지의 정수 금액이며, $50부터 +5%, $100부터 +10%, $200부터 +15%의 보너스가 제공됩니다. 암호화폐(TRC20의 USDT, Base의 USDC)로 결제할 수 있습니다. 가격 책정 페이지에 표가 나와 있습니다. 아직 키가 없다면 여기서 얻으세요.

도구당 하나의 키를 유지하세요. 여러 편집기 및 스크립트에 키를 붙여넣으면 속도 제한이 공유되어 무작위 오류처럼 보일 수 있습니다.

고집스러운 경우를 위한 스크립트 확인

여전히 원인을 찾지 못했다면 편집기가 수행하는 작업을 복사하는 짧은 스크립트를 실행하세요. 이 스크립트는 Cursor 스타일 클라이언트의 모델이 된 OpenAI SDK를 사용하며 정확한 오류 객체를 출력합니다.

from openai import OpenAI, APIStatusError

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

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

스크립트가 텍스트를 스트리밍하고 엔드포인트, 키, 모델이 올바르게 설정되었는데도 문제가 발생한다면, 남은 원인은 Cursor 설정에 있습니다. 상태 코드를 출력한다면 위의 표를 참조하세요. 지원팀에 문의할 때 X-Request-Id 값을 함께 제공하세요. 이는 정확한 요청을 식별하는 데 사용됩니다. 전체 파라미터 세부 정보는 문서 페이지에서 확인할 수 있습니다.

다시 깨지지 않도록 유지하기

대부분의 반복 문제를 방지하는 몇 가지 습관이 있습니다. 채팅 기록이나 메모에서 줄 바꿈이 숨어들 수 있으므로 키를 하나의 비밀번호 관리자 항목에 저장하고 거기서 복사하세요. 편집기 업데이트 후 다시 입력할 수 있도록 세 가지 값(베이스 URL, 키, 모델 이름)을 기록하세요. 업데이트 후 실제 작업을 시작하기 전에 짧은 채팅 메시지 하나를 보내세요.

잔액을 모니터링하세요. X-Balance-USD 헤더는 각 응답에 반환되며 GET /v1/balance에서도 읽을 수 있습니다. 크레딧은 만료되지 않으므로 계정에 남아 있는 소액 충전은 낭비되지 않습니다. 편집기 외에도 스크립트에서 키를 사용하는 경우 429 오류 발생 시 5초 대기 후 몇 번의 시도 후 중단되는 재시도 루프를 긴 배치 작업에 제공하여 스크립트가 편집기의 동시성 슬롯을 고갈시키지 않도록 하세요.

파일 컨텍스트 10,000개 토큰과 700개 토큰 답변이 포함된 코딩 채팅 요청의 입력 비용은 10,000 / 1,000,000 x $0.15 = $0.0015이며 출력 비용은 700 / 1,000,000 x $0.50 = $0.00035로 총 약 $0.00185입니다. 요금은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. Cursor API 가격 책정에 대한 기사는 월별 견적을 다룹니다.

실패한 요청이 큰 요청이었다면 컨텍스트 창을 기억하세요: 프롬프트와 완성의 합계가 100,000 토큰을 초과할 수 없으며 요청 본문은 8 MB로 제한됩니다. 전체 저장소를 채팅에 첨부하면 둘 다 초과할 수 있습니다. 관련 파일로 컨텍스트를 줄이고 다시 시도하세요.

01

질문과 답변

Cursor에서 내 API 키가 유효하지 않다고 표시하는 이유는 무엇인가요?

보통 키에 불필요한 공백이 있거나 부분적으로 복사되었거나, 베이스 URL이 다른 서비스를 가리키고 있습니다. 키를 다시 복사한 후 오버라이드 URL이 https://api.cursorapikey.com/v1인지 확인하세요.

어떤 모델 이름을 입력해야 하나요?

uncensored를 소문자로 입력하세요. API에서 제공하는 유일한 모델 ID입니다.

자동 완성 기능이 내 키를 사용하나요?

반드시 그런 것은 아닙니다. 일부 Cursor 기능은 Cursor 자체 모델을 사용하며, 사용자 지정 키는 주로 모델을 선택할 수 있는 채팅 및 수정 모드에 적용됩니다.

실패한 요청에 대해 요금이 부과되나요?

아닙니다. 실패하거나 거부된 요청에는 요금이 부과되지 않으므로 디버깅 중 재시도해도 비용이 들지 않습니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.