KO ▾
API 키 받기

cursorapikey.com/가이드

Cursor API 키를 커스텀 엔드포인트와 함께 사용하는 방법

Cursor API 설정을 자신의 엔드포인트와 함께 사용하는 방법은 다음과 같습니다: 키를 붙여넣고, OpenAI 베이스 URL을 재정의하며, 모델명 uncensored을 추가하십시오. 아래 단계는 약 5분이 소요되며, 먼저 실행할 수 있는 curl 확인이 포함됩니다.

업데이트

커스텀 API 엔드포인트를 나타내는 서버 큐브에 빛나는 케이블로 연결된 등각 코드 편집기

주요 포인트

  • Cursor는 OpenAI의 베이스 URL과 API 키를 재정의할 수 있으므로, OpenAI 호환 엔드포인트가 요청을 처리할 수 있습니다.
  • 베이스 URL https://api.cursorapikey.com/v1과 모델 ID uncensored를 사용하십시오.
  • 에디터를 수정하기 전에 curl로 API 키를 테스트하면, 오류가 어디서 발생했는지 파악할 수 있습니다.
  • 20,000 토큰의 프롬프트와 1,000 토큰의 답변은 $0.0035가 소요됩니다.

이 가이드의 내용

Cursor API 사용 방법을 검색하는 사람들은 보통 두 가지 중 하나를 의미합니다. 하나는 코드에서 일부 Cursor 서비스를 호출하려는 경우이고, 다른 하나는 Cursor 편집기가 모델 요청을 사용자가 선택한 엔드포인트로 보내려는 경우입니다. 이 가이드는 두 번째 경우에 관한 것입니다. 이 사이트는 OpenAI 채팅 완료 프로토콜을 사용하는 독립적인 호스팅 API이므로 Cursor는 어떤 OpenAI 스타일 서버에 접속하듯 여기에 접속할 수 있습니다.

배경 모델은 단일 오픈 웨이트 모델로, 독립적인 제공업체가 실행하며 합법적인 성인 사용에 대한 콘텐츠 거부 없이 답변하도록 조정되었습니다. 이것은 공식적인 Cursor 모델이 아니며, 벤더 간 라우터도 아닙니다. 텍스트만 처리합니다. 코딩에는 보통 충분합니다: 코드와 지시를 보내면 코드와 설명을 받습니다.

세 가지가 필요합니다: API 키, 베이스 URL https://api.cursorapikey.com/v1, 그리고 모델 ID uncensored. 나머지는 편집기에서 올바른 필드를 찾는 문제입니다.

1단계: 키를 얻고 curl로 확인

Google 또는 이메일과 비밀번호로 가입한 후 API 키 페이지를 엽니다. 새 계정은 한 번의 클릭으로 $0.50의 무료 체험 크레딧을 청구할 수 있습니다. 카드가 필요 없으며 7일 동안 유효합니다. 체험 키는 동시 요청 2개 및 분당 60개의 요청으로 제한되며, 편집기에서 첫 세션에는 충분합니다.

Cursor를 열기 전에 키가 작동하는지 확인하십시오. 환경 변수에 키를 사용하여 터미널에서 다음을 실행하십시오:

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

첫 번째 호출은 모델을 나열합니다. 두 번째 호출은 정상적인 채팅 완료를 반환합니다. 둘 다 성공하면 편집기에서 이후의 실패는 키 문제가 아닌 설정 문제입니다. 이 구별은 많은 추측을 줄여줍니다.

2단계: Cursor에서 베이스 URL과 키 설정

Cursor의 설정을 열고 모델 섹션으로 이동하십시오. 메뉴 이름과 레이아웃은 릴리스 간에 변경되므로 아래 레이블을 지도로 간주하고 이동된 항목이 있으면 Cursor의 자체 문서를 확인하십시오.

  1. OpenAI API 키 필드를 찾아 이 사이트에서 키를 붙여넣으십시오.
  2. OpenAI 베이스 URL 재정의 옵션을 활성화하고 https://api.cursorapikey.com/v1를 입력하십시오. 끝에 /v1을 유지하고 /chat/completions을 추가하지 마십시오; 클라이언트 앱이 경로를 자체적으로 추가합니다.
  3. 커스텀 모델을 추가하고 정확히 소문자로 uncensored를 입력하십시오.
  4. 편집기에서 확인 또는 저장 버튼을 제공하면 사용하십시오. 그런 다음 채팅 패널에서 새 모델을 선택하십시오.

파일을 연 채 "이 함수를 설명해 주세요"와 같은 짧은 메시지를 보내십시오. 스트리밍된 답변은 경로가 끝까지 작동함을 의미합니다. Cursor는 요청을 보내고, 엔드포인트는 SSE를 통해 토큰을 스트리밍하며, 편집기는 도착하는 대로 렌더링합니다.

두 가지 주의사항입니다. 인라인 탭 완성과 같은 일부 편집기 기능은 Cursor가 관리하는 모델에서 실행될 수 있으며 API 키를 무시할 수 있으므로, 어떤 기능이 실제로 사용자 정의 모델을 사용하는지 확인해야 합니다. 또한 Cursor가 사용자 정의 키 트래픽을 자체 서버로 라우팅할 수 있으므로, 코드가 정확히 어디를 거치는지 확인하려면 현재 문서를 참조해야 합니다. 이 사이트의 퀵스타트에는 API 계약의 내용이 나열되어 있습니다.

코드에서 동일한 엔드포인트 테스트

문제를 분리하는 가장 쉬운 방법은 공식 OpenAI SDK로 엔드포인트를 호출하는 것입니다. 그 결과가 정상이라면 엔드포인트는 정상이며 나머지 문제는 편집기 설정에 있습니다.

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Node에서의 동일한 작업:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

스트리밍 응답에는 사용량 정보가 마지막에 포함되므로 요청에 사용된 토큰 수를 정확히 로깅할 수 있습니다. 각 응답에는 남은 크레딧을 알려주는 X-Balance-USD 헤더와 문제가 있을 때 참조할 수 있는 X-Request-Id도 포함됩니다.

코딩 워크플로우에서 작동하는 것

API는 스트리밍, JSON 모드, 함수 호출(tools, tool_choice, 스트리밍 중 tool_calls, 그리고 role: "tool"로 반환되는 결과)을 지원합니다. temperature, top_p, stop, seed과 같은 샘플링 설정과 페널티가 전달됩니다. 컨텍스트 창은 프롬프트와 완성 텍스트를 합쳐 100,000 토큰이며, max_tokens은 선택 사항입니다.

이 100,000 토큰은 코드 작업에 충분한 여유가 있습니다. 수백 줄의 소스 파일은 수천 토큰에 불과하므로, 여러 파일과 긴 지시문을 포함해도 답변을 위한 공간이 남습니다. 최대 요청 본문 크기는 8 MB이며, 텍스트의 경우 이 한도에 도달하지 않습니다.

편집기에서 커스텀 모델을 즐겁게 사용하는 몇 가지 습관:

  • 코드 수정에는 낮은 temperature을 유지하십시오. 0.2 전후의 값은 더 안정적인 출력을 제공하며, 브레인스토밍 시에만 높여야 합니다.
  • 필요한 파일만 첨부하십시오. 보내는 모든 토큰은 입력으로 청구되며, 전체 대화는 각 턴마다 다시 전송됩니다.
  • 파일이 길면 전체 파일 대신 diff 또는 변경된 함수를 요청하십시오. 출력 토큰은 입력 토큰보다 비용이 더 많이 듭니다.
  • 거부가 방해가 되는 작업에 모델을 사용하십시오. 예를 들어 자체 연구소용 익스플로이트 proof-of-concepts 작성, 연구가 허가된 악성 코드 샘플 분석 또는 거친 실제 콘텐츠를 모방하는 테스트 데이터 생성 등이 있습니다. 모두 합법적이어야 합니다.

반복해서 강조할 하드 리밋 하나: 어떤 맥락이든 미성년자가 포함된 성적인 콘텐츠는 허용되지 않습니다.

일반적인 오류 수정

증상잠재적 원인해결 방법
401 또는 "잘못된 키"공백이 포함된 키 또는 오래된 키가 붙여넣어짐키 페이지에서 다시 복사; curl로 테스트
404 또는 "모델을 찾을 수 없음"모델 이름이 다르게 입력됨uncensored를 소문자로, 접미사 없이 사용하십시오.
경로에서 404베이스 URL에는 /chat/completions이 포함됩니다.베이스 URL은 /v1에서 끝납니다.
concurrency 관련 429너무 많은 동시 요청스트림이 완료될 때까지 기다립니다. 전체 키는 8개, 체험 키는 2개의 동시 연결을 허용합니다.
rate_limited과 함께 429분당 300개를 초과하는 요청 (체험 키는 60개)요청 속도를 줄이거나 일시 정지 후 재시도
Retry-After: 5 헤더를 포함하는 429 상태 코드일시적 과부하5초 후 재시도

스트리밍 요청은 스트림 데이터 전송이 종료될 때까지 동시성 슬롯을 유지합니다. Cursor에서 여러 채팅을 시작하고 생성을 계속 두면 체험 키의 동시성 제한에 빠르게 도달할 수 있습니다. 실패하거나 거부된 요청은 요금이 부과되지 않으므로 재시도해도 추가 비용이 들지 않습니다.

코딩 세션 비용

가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50이며, 구독 없이 선불 크레딧으로 결제합니다. 일반적인 에디터 요청은 큰 프롬프트(사용자의 파일)와 짧은 답변으로 구성됩니다. 입력 토큰 20,000개와 출력 토큰 1,000개를 가정합니다:

  • 입력: 20,000 x $0.15 / 1,000,000 = $0.0030
  • 출력: 1,000 x $0.50 / 1,000,000 = $0.0005
  • 총 비용: 요청당 $0.0035

작업일 기준 100개 요청 시 $0.35입니다. $0.50 체험 크레딧은 이러한 요청 약 140개를 커버합니다. 체험 기간 후 $20부터 $500까지 정수 금액으로 충전할 수 있으며, $50부터 +5%, $100부터 +10%, $200부터 +15% 보너스 크레딧을 제공합니다. 암호화폐(TRC20의 USDT, Base의 USDC)로 결제할 수 있습니다. 크레딧은 만료되지 않으므로 천천히 사용하는 충전액은 낭비되지 않습니다. 요금 페이지에 전체 표가 있으며, Cursor 및 Copilot 대체재 페이지는 이 서비스가 구독형 편집기 옆에서 어디에 위치하는지 설명합니다.

프롬프트는 학습에 사용되지 않습니다.

01

질문과 답변

Cursor 에이전트 및 함수 호출과 호환되나요?

API는 tools, tool_choice, 스트리밍된 tool_calls를 사용한 함수 호출을 지원합니다. 특정 Cursor 기능이 커스텀 모델을 사용하는지는 에디터에 따라 다르므로, 설정 후 각 기능을 테스트해야 합니다.

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

소문자로 uncensored를 입력하십시오. 이것이 유일한 모델 ID이며, GET /v1/models 엔드포인트는 이를 나열합니다.

이것이 공식 Cursor API인가요?

아니요. 이는 단일 오픈 웨이트 모델 앞에 배치된 독립적인 OpenAI 호환 API입니다. Cursor는 단순히 OpenAI 설정을 다른 엔드포인트로 가리키도록 할 뿐입니다.

시도해 보려면 카드가 필요한가요?

아니요. $0.50 무료 체험 크레딧은 가입 후 API 키 페이지에서 한 번의 클릭으로 청구할 수 있으며, 카드가 필요 없고 7일 동안 유효합니다.

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

계정을 생성하고 키를 복사한 후 베이스 URL을 변경하십시오. 설정은 이것으로 끝입니다.