Cursor에서 DeepSeek API 사용법: 사용자 지정 Base URL 설정

짧은 답변

Cursor에서 deepseek api를 사용하는 방법을 알고 싶다면 과정은 모든 OpenAI 호환 제공업체와 동일합니다. Cursor의 모델 설정을 열고 OpenAI 키 필드에 API 키를 붙여넣고 OpenAI base URL을 재정의한 후 Cursor가 알지 못하는 모델 이름을 추가합니다. 그런 다음 채팅에서 해당 모델을 선택합니다.

시작하기 전 한 가지 명확히 합니다. 이 사이트는 공식 DeepSeek API가 아닙니다. 이는 독립적인 제공업체가 운영하고 합법적인 성인용 사용을 위해 콘텐츠 거부 없이 답변하도록 조정된 하나의 오픈 웨이트 모델을 실행하는 호스팅된 OpenAI 호환 텍스트 API입니다. 모델 ID는 uncensored입니다. 공식 DeepSeek 서비스가 필요하면 벤더의 자체 엔드포인트와 키를 사용하세요. Cursor의 설정은 어느 쪽이든 동일해 보입니다: 세 값만 변경됩니다.

Cursor 열기 전: 키 얻기 및 테스트

구글 또는 이메일과 비밀번호로 가입합니다. 이후 API 키 페이지에는 $0.50의 무료 체험 크레딧을 추가하는 원클릭 버튼이 있습니다. 7일 동안 유효하며 카드가 필요 없고 1인당 한 번으로 제한됩니다. 이는 몇백 개의 짧은 코딩 질문에 충분하므로 아무것도 결제하기 전에 전체 설정을 완료할 수 있습니다. 키 페이지에서 단계를 안내합니다.

이제 Cursor 외부에서 키를 테스트하세요. Cursor의 오류 메시지는 짧고 키의 오타는 잘못된 URL과 동일하게 보입니다. 터미널에서 다음을 실행하세요:

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
  }'

choices[0].message.content에 함수가 포함된 JSON 응답을 받아야 합니다. 또한 GET /v1/models로 모델을 나열할 수 있으며 이는 키가 승인되었는지 빠르게 확인하는 방법입니다. 이것이 작동하면 엔드포인트 측 작업이 완료되고 남은 것은 모두 Cursor 구성입니다.

Cursor 단계별 구성

1. Cursor 설정을 열고 Models 섹션으로 이동합니다. 대부분의 빌드에서는 기어 아이콘을 통해 Models에 접근합니다.
2. OpenAI API 키 필드를 찾아 키를 붙여넣습니다. Cursor가 검증을 요청할 수 있습니다. 사용자 지정 엔드포인트의 경우 Cursor가 키를 자체 모델 목록과 비교하므로 검증이 실패할 수 있습니다. 그렇다면 다음 단계로 진행하고 채팅이 작동하는지 여부에 따라 판단하세요.
3. OpenAI base URL 재정의 옵션을 켜고 https://api.deepseekapi.top/v1를 입력합니다. 끝에 /v1을 포함하세요. /chat/completions을 추가하지 마세요. 클라이언트 앱이 해당 경로를 자체적으로 추가합니다.
4. 모델 추가 버튼을 사용하여 uncensored를 정확히 소문자로 입력하세요. 모델 목록에서 활성화합니다.
5. 채팅 패널을 열고 모델 선택기에서 uncensored를 선택한 후 짧은 프롬프트를 보내세요.

메뉴 이름은 Cursor 릴리스 간에 변경되므로 위의 레이블과 다른 경우 동일한 세 가지 항목을 찾아보세요: 키, base URL, 사용자 지정 모델. Cursor의 자체 문서에서 현재 이름을 확인할 수 있습니다.

주의할 설정

Cursor는 단일 OpenAI base URL 재정의만 유지합니다. 활성화된 동안 Cursor에서 사용하는 모든 OpenAI 이름의 모델은 새 주소로 전송됩니다. 다른 OpenAI 호환 서비스도 사용하고 싶다면 재정의 옵션을 끄거나 별도 프로필을 사용하세요.

사용자 지정 엔드포인트에서 작동하는 기능

사용자 지정 키는 채팅 모델을 호출하는 기능에 사용됩니다: 채팅 패널 및 인라인 편집. 이들은 이 API가 받는 표준 채팅 completions 요청을 보냅니다. 서비스는 SSE를 통한 스트리밍을 지원하므로 응답은 다른 제공업체와 마찬가지로 채팅 패널에 토큰 단위로 나타납니다.

일부 Cursor 기능은 탭 완성처럼 Cursor 자체 모델과 서버에 의존합니다. 이러한 기능은 사용자의 키로 전환되지 않습니다. 또한 Cursor는 요청이 엔드포인트에 도달하기 전에 자체 백엔드를 통해 라우팅할 수 있으므로 네트워크 위치나 로깅이 중요하면 문서를 확인하세요. 당사 측에서는 프롬프트를 학습에 사용하지 않습니다.

에이전트 스타일 기능은 함수 호출에 의존합니다. API는 tools, tool_choice 및 스트리밍 tool_calls를 통한 함수 호출을 지원하며 결과는 role: "tool"로 반환됩니다. 특정 Cursor 모드가 사용자 지정 모델과 함께 해당 경로를 사용하는지는 버전마다 다를 수 있으므로 워크플로우를 구축하기 전에 작은 작업으로 테스트해야 합니다.

컨텍스트 창은 프롬프트와 완료를 합쳐 100,000 토큰입니다. 이는 여러 파일을 동시에 처리하기에 충분히 크지만 Cursor가 무엇을 첨부할지 결정하며 큰 첨부 파일은 메시지마다 입력 토큰 비용이 듭니다.

편집기에서 잘 작동하는 프롬프트

편집기의 채팅 모델은 제공된 컨텍스트만큼만 유용합니다. 사용자 지정 엔드포인트 뒤의 모든 모델에서 눈에 띄는 차이를 만드는 몇 가지 습관이 있습니다.

• 필요한 파일만 첨부하세요. 첨부된 파일은 모든 턴에서 입력 토큰입니다. 관련 파일 두 개가 관련성 낮은 파일 열 개보다 품질과 비용 모두에서 더 낫습니다.
• 작업과 제약 조건을 명시하세요. "이 함수를 재귀를 피하도록 다시 작성하고 시그니처를 유지하세요"가 "더 좋게 만들어 주세요"보다 더 잘 작동합니다.
• diff 크기의 답변을 요청하세요. 작은 변경이 필요하다고 말하세요. 그렇지 않으면 모델이 전체 파일을 다시 작성할 수 있으며 출력 토큰에 대해 지불합니다.
• 작업당 새 채팅을 시작하세요. 이전 턴이 다시 전송됩니다. 깨끗한 채팅은 가장 저렴한 컨텍스트 정리 방법입니다.

이 모델은 합법적인 성인용 사용에 맞게 콘텐츠 거부 없이 답변하도록 튜닝되었습니다. 따라서 자체 코드에서 알려진 취약점 클래스의 작동 방식과 같은 보안 관련 코딩 질문은 경고보다는 직접적인 답변을 얻는 경향이 있습니다. 다른 언어 모델처럼 실수를 할 수 있으므로, 무언가를 커밋하기 전에 제공된 코드를 읽고 테스트를 실행하세요.

긴 답변이 중단되면 아래 제한 섹션을 확인하세요. 무료 체험 키에서 두 개의 편집기 창이 동시에 스트리밍하면 두 개의 동시 요청 슬롯이 모두 채워지고 세 번째 요청은 대기하거나 429를 반환합니다.

편집기에서의 비용

가격은 선불 크레딧 기준 입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50입니다. 구독이 없으며 실패하거나 거부된 요청은 요금이 부과되지 않고 크레딧은 만료되지 않습니다.

편집기에서의 일반적인 채팅 턴은 많은 입력(첨부한 파일과 기록 포함)과 짧은 답변을 가집니다. 입력 토큰 6,000과 출력 토큰 700을 가정해 보세요:

• 입력: 6,000 × $0.15 / 1,000,000 = $0.0009
• 출력: 700 × $0.50 / 1,000,000 = $0.00035
• 합계: 턴당 $0.00125

이 크기로 100 턴은 $0.125가 듭니다. 400 턴의 긴 작업 하루는 $0.50이 듭니다. 대화가 길어지면 입력이 청구서의 대부분을 차지합니다. Cursor가 기록을 다시 보내기 때문입니다. 작업을 변경할 때 새 채팅을 시작하는 것이 이 숫자를 낮게 유지하는 가장 쉬운 방법입니다.

무료 체험을 넘어 더 많은 크레딧이 필요하면 충전 금액은 $20에서 $500 사이의 정수 금액이며 $50부터 +5%, $100부터 +10%, $200부터 +15%의 보너스가 제공됩니다. 카드(Visa, Mastercard, Apple Pay, Google Pay) 또는 암호화폐(TRC20의 USDT, Base의 USDC)로 결제할 수 있습니다. 자세한 내용은 가격 책정 페이지에서 확인하세요.

문제 해결

401 또는 유효하지 않은 키

키에 끝에 공백이 포함된 채 붙여넣어졌거나 다른 사이트의 키입니다. 동일한 문자열로 curl 테스트를 다시 실행하세요. curl이 작동하고 Cursor가 작동하지 않으면 키를 다시 붙여넣으세요.

404 또는 모델을 찾을 수 없음

보통 base URL에 /v1이 누락되었거나 끝에 불필요한 경로가 있습니다. 모델 이름은 정확히 uncensored이어야 합니다.

429 응답

전체 키는 동시 요청 8개와 분당 300개의 요청을 허용합니다. 무료 체험 키는 동시 요청 2개와 분당 60개를 허용합니다. 오류 코드 rate_limited은 분당 요청이 너무 많음을 의미하고 concurrency은 동시에 너무 많음을 의미합니다. 일시적인 과부하 시에도 Retry-After: 5와 함께 429를 받습니다. 스트리밍된 응답은 스트림이 끝날 때까지 슬롯을 유지하므로 여러 편집기 창이 동시에 스트리밍하면 무료 체험 키에서 동시 요청 제한에 도달할 수 있습니다.

모델이 응답을 거부하거나 주제를 벗어남

이 모델은 합법적인 성인용 콘텐츠 거부를 피하도록 조정되었지만, 여전히 언어 모델이며 프롬프트를 따릅니다. 명확한 시스템 지시와 정확한 작업을 제공하세요. 미성년자가 포함된 성 콘텐츠는 절대 허용되지 않는다는 하드 리밋이 있습니다.

빠른 시작 문서에는 각 응답에서 반환되는 헤더 목록이 포함되어 있으며, 여기에는 X-Request-Id가 포함되어 있어 지원팀에 문의할 때 인용하는 데 유용합니다.

더 많은 가이드

• SillyTavern에서 DeepSeek API 사용하는 방법: 커스텀 엔드포인트
• DeepSeek API Python 예제: 채팅, 스트리밍, 도구
• DeepSeek API 키: 무검열 LLM API 접근