KO ▾
API 키 받기

cursorapikey.com/문서

Cursor 사용자를 위한 빠른 시작

기본 URL 및 인증 헤더를 업데이트하여 코딩 도구를 무검열 API에 연결하세요. 이 빠른 시작 가이드에서는 Cursor 및 기타 OpenAI 호환 에이전트에 필요한 기본 구성을 다룹니다.

기본 URL 및 인증

클라이언트를 https://api.cursorapikey.com/v1을 가리키도록 구성하세요. 서비스는 표준 OpenAI 인증 헤더를 기대합니다. API 키 가져오기 페이지에서 키를 생성하세요. 모든 요청에 필요합니다. 단일 사용 가능한 모델에 액세스하려면 모델 ID uncensored를 사용하세요. 이 설정은 Cursor, Claude Code 또는 GitHub Copilot 사용자 정의 엔드포인트와 같은 모든 OpenAI 호환 SDK 또는 에이전트에서 작동합니다.

첫 번째 요청

간단한 채팅 완료로 연결성을 테스트하세요. 엔드포인트는 표준 요청 본문을 지원합니다. 200 상태 코드를 받으면 구성이 올바릅니다. 401 오류는 유효하지 않거나 누락된 키를 의미하며, 402 오류는 선불 크레딧이 고갈되었음을 의미합니다.

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 blunt product review of a cheap VPN."}]
  }'

8 MB를 초과하거나 분당 300건을 초과하는 요청은 특정 오류 코드를 반환할 수 있습니다. 자세한 내용은 속도 제한 섹션을 확인하세요.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하세요. 클라이언트 초기화 시 기본 URL과 API 키를 설정하세요. 모델 ID는 여전히 uncensored입니다. 이 방법은 프로그래밍 방식의 API 접근이 필요한 로컬 스크립트 또는 에이전트 통합에 적합합니다. 라이브러리 버전이 필요한 OpenAI API 구조를 지원하는지 확인하세요.

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

프롬프트는 학습에 사용되지 않음을 기억하세요. 코드 컨텍스트는 요청에 대해 비공개로 유지됩니다.

Node SDK 통합

사용자 정의 기본 URL로 OpenAI Node.js 클라이언트를 초기화하세요. 환경 변수에서 API 키를 전달하세요. 모든 완료에 모델 ID uncensored가 필요합니다. 이 설정은 일관된 AI 지원이 필요한 Node 기반 에이전트 또는 서버리스 함수에 이상적입니다.

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

불필요한 402 오류를 피하기 위해 대량 요청을 수행하기 전에 자격 증명을 확인하세요.

스트리밍 응답

요청 본문에 stream: true를 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE)를 반환합니다. 이를 통해 UI 또는 에이전트는 생성되는 대로 토큰을 처리할 수 있습니다. 스트리밍은 큰 응답의 지각된 지연 시간을 줄입니다. 클라이언트가 부분 청크를 올바르게 처리하는지 확인하세요.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

각 청크에는 부분 콘텐츠가 포함됩니다. 이를 집계하여 최종 응답을 구성하세요.

제한, 오류 및 컨텍스트

컨텍스트 창은 프롬프트와 생성 결과를 합쳐 100,000 토큰입니다. 속도 제한은 키당 분당 300 요청입니다. 키를 재생성하면 이전 키는 즉시 무효화됩니다. 401 오류는 유효하지 않은 키를 의미합니다. 402 오류는 잔액 부족을 의미합니다. 429 오류는 속도 제한 초과를 의미합니다. 선불 크레딧은 만료되지 않습니다. 충전 옵션에는 암호화폐(USDT 또는 USDC)가 포함됩니다.

API 사양

크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.

항목내용
형식OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작
모델 IDuncensored
인증Authorization: Bearer YOUR_KEY
Base URLhttps://api.cursorapikey.com/v1
엔드포인트POST /v1/chat/completions · GET /v1/models
파라미터temperature, top_p, stop, seed, presence_penalty, frequency_penalty
JSON 모드response_format: {"type": "json_object"}
최대 출력100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음)
컨텍스트 창100,000 토큰 (입력 + 출력)
함수 호출지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송
스트리밍지원 — SSE, 마지막 청크에 토큰 사용량 포함
요청 크기최대 8 MB
동시 요청키당 동시 8개
속도 제한키당 분당 300회
응답 헤더X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
가격입력 100만 토큰당 $0.25 · 출력 100만 토큰당 $1.00
무료 체험$0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용
보너스$50 이상 +5%, $100 이상 +10%
유효기간유료 크레딧은 만료되지 않으며 구독 없음
충전USDT (TRC20) 또는 USDC (Base), $10~$500 사이 원하는 정수 금액
과금선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료
로그인Google 또는 이메일과 비밀번호
키계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효
콘텐츠성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부

오류 코드

오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.

코드유형의미
400bad_request잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과
401missing_key · invalid_key · key_revoked키 없음·잘못됨·새 키로 교체됨
402no_credit잔액 없음 — 충전하면 즉시 재개
403content_blocked미성년자 관련 성적 콘텐츠 — 거부, 과금 없음
404not_found알 수 없는 엔드포인트
413request_too_large본문 8 MB 초과
429rate_limited · concurrency분당 300회 또는 동시 8개 초과 — 잠시 후 재시도
503upstream_busy모델 혼잡 — 몇 초 후 재시도
01

질문과 답변

공식 Cursor API인가요?

아니요, 독립적인 서비스입니다. OpenAI 호환이며 Cursor 및 유사한 도구에서 사용자 정의 엔드포인트로 작동합니다. Cursor, OpenAI 또는 Anthropic과 제휴 관계가 아닙니다.

속도 제한을 초과하면 어떻게 되나요?

분당 300건을 초과하는 요청은 429 오류를 반환합니다. 이 제한은 키별로 적용됩니다. 키를 재생성하면 이전 키가 무효화되지만 새 키의 속도 제한 시간 창은 초기화되지 않습니다.

계정을 어떻게 충전하나요?

암호화폐(USDT 또는 USDC)를 사용하여 $10부터 충전할 수 있습니다. 보너스 크레딧도 제공됩니다: $50부터 +5%, $100부터 +10%. 유료 크레딧은 만료되지 않습니다.

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

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