KO ▾
API 키 받기

deepseek4api.com가이드

VS Code의 무검열 AI: Continue, Cline, Cursor

deepseek v4 api vscode 설정은 세 가지 값으로 요약됩니다: Base URL, API 키, 모델 ID. 이 가이드는 Continue, Cline, Cursor에 이 값을 정확히 붙여넣는 위치, 연결을 먼저 테스트하는 방법, 실패 시 처리 방법을 보여줍니다.

업데이트

API 엔드포인트를 나타내는 케이블로 연결된 코드 편집기 패널과 빛나는 클라우드 노드의 등각 일러스트레이션

주요 포인트

  • 사용자 정의 OpenAI 호환 제공자를 지원하는 모든 편집기 확장 프로그램은 base URL https://api.deepseek4api.com/v1과 모델 ID uncensored을 사용합니다.
  • 편집기를 수정하기 전에 GET /v1/models에 대해 curl로 테스트하여 키와 URL이 정확한지 확인하세요.
  • API는 채팅 완료만 지원하므로 채팅, 수정, 에이전트에 사용하세요. 인라인 탭 자동 완성에는 사용하지 마세요.
  • 컨텍스트가 8,000 토큰인 일반적인 코딩 질문에는 약 $0.0017이 듭니다.

시작하기 전에 필요한 항목

자체 모델을 가져올 수 있는 편집기들은 모두 동일한 세 가지 항목을 요청합니다. 여기 해당 서비스의 항목들이 있습니다.

설정내용
Base URLhttps://api.deepseek4api.com/v1
API 키API 키 페이지에서 발급받은 키로, Authorization: Bearer 형식으로 전송합니다.
모델 IDuncensored
제공자 유형"OpenAI" 또는 "OpenAI 호환"

나중에 놀라지 않도록 빠르게 설명합니다. 이 사이트 이름에 DeepSeek V4가 언급되어 있지만, 엔드포인트의 모델은 독립적인 제공자가 운영하는 오픈 웨이트 모델입니다. DeepSeek 공식 API가 아닙니다. 편집기에서 범용 OpenAI 호환 제공자를 선택하세요. 벤더 전용 제공자는 선택하지 마세요. 벤더 전용 제공자는 해당 벤더의 서버를 가리키고 base URL을 무시하기 때문입니다.

새로운 사용자는 가입 후 한 번의 클릭으로 카드 없이 $0.50의 체험 크레딧을 받을 수 있으며, 이는 아래 테스트에 충분합니다. 체험 키는 동시 요청 2개와 분당 60개 요청으로 동작합니다.

터미널에서 엔드포인트 먼저 테스트

에디터 설정 문제의 절반은 잘못된 URL이나 오타가 난 키 때문입니다. 에디터는 어떤 문제가 있는지 알려주지 않습니다. curl 명령어 두 개로 추측을 없앨 수 있습니다. VS Code 내부 터미널을 열고(Windows 및 Linux는 Ctrl+`, macOS는 Cmd+`) 첫 번째 명령어를 실행하세요.

# expect the model id "uncensored" in the list
curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

모델 uncensored이 포함된 JSON 목록이 표시되어야 합니다. 이제 실제 채팅 요청을 보내세요:

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

두 명령어가 모두 작동하면 편집기도 동일한 값으로 작동합니다. 첫 번째 명령어에서 인증 오류가 발생하면 키가 잘못되었거나 불필요한 공백이 있습니다. 404 오류가 발생하면 URL이 /v1로 끝나고 그 뒤에 추가 경로가 없는지 확인하세요.

VS Code에서 Continue

Continue는 VS Code 및 JetBrains용 오픈 소스 어시스턴트 확장 프로그램입니다. 확장 프로그램 뷰에서 설치하고 패널을 연 다음 기어 아이콘에서 구성 파일을 엽니다. 최신 버전에서는 파일이 config.yaml이며, 이 API를 위한 모델 항목은 다음과 같습니다:

models:
  - name: Uncensored API
    provider: openai
    model: uncensored
    apiBase: https://api.deepseek4api.com/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply
    defaultCompletionOptions:
      contextLength: 100000
      maxTokens: 2000
      temperature: 0.4

이전 Continue 버전은 models 배열을 사용하는 config.json을 사용하며, 동일한 필드가 "provider": "openai", "model": "uncensored" 및 "apiBase": "https://api.deepseek4api.com/v1"로 나타납니다. 파일 형식은 버전 간에 변경되었으므로 패널에 다른 레이아웃이 표시되면 Continue가 생성한 구조를 따르고 이 세 가지 값을 교체하세요.

100000 컨텍스트 길이는 이 API의 컨텍스트 윈도우(프롬프트와 완성의 합계)과 일치합니다. 더 낮은 maxTokens 값은 각 응답의 상한선입니다. 필요 없는 긴 응답을 방지합니다. 파일을 저장하고 Continue 채팅 드롭다운에서 모델을 선택한 후 열린 파일에 대해 질문합니다. 코드를 강조 표시하고 편집 명령을 사용하여 선택한 부분을 다시 작성합니다.

Cline

Cline은 파일을 읽고 수정을 제안하며 사용자의 승인을 받아 명령을 실행하는 에이전트 스타일 확장 프로그램입니다. 설정을 열고 "OpenAI Compatible"이라는 API 제공자를 선택한 후 필드를 채우세요:

  1. Base URL: https://api.deepseek4api.com/v1
  2. API Key: 본인의 키
  3. 모델 ID: uncensored

에이전트는 말이 많습니다. 단일 작업은 도구가 파일을 읽고 수정하며 결과를 확인하는 동안 여러 요청을 트리거할 수 있으며, 각 요청은 지금까지의 대화를 다시 전송합니다. 이때 비용 계산이 중요합니다. 에이전트 단계에 40,000 토큰의 컨텍스트가 있고 1,500 토큰을 작성한다고 가정해 보세요. 비용은 40,000 x $0.15 / 1M + 1,500 x $0.50 / 1M로, $0.006 + $0.00075, 즉 $0.00675입니다. 하나의 작업에 대해 20단계면 $0.135입니다. 하나의 대화가 몇 시간 동안 이어지도록 두지 말고 새 작업을 시작하면 청구 금액이 일정하게 유지됩니다.

API는 함수 호출을 지원합니다(tools, tool_choice 및 스트리밍 tool_calls, 결과는 role: "tool"로 반환됨). 에이전트 확장 프로그램이 이에 의존합니다. 자체 에이전트를 빌드하는 경우 정확한 요청 구조는 문서을 참조하세요.

Cursor 및 기타 편집기

Cursor는 VS Code 코드베이스를 기반으로 구축된 별도의 편집기입니다. 자체 OpenAI 키를 입력하고 OpenAI Base URL을 재정의할 수 있는 모델 설정 페이지가 있습니다. https://api.deepseek4api.com/v1을 붙여넣고 키를 붙여넣은 후 uncensored라는 사용자 정의 모델을 추가하세요. Cursor의 옵션 및 계획 규칙은 시간이 지남에 따라 변경되므로 재정의가 어디에 있는지, 어떤 기능이 이를 사용하는지 현재 문서를 확인하세요. 탭 자동 완성 등 Cursor 자체 모델로 실행되는 기능은 엔드포인트를 거치지 않습니다.

동일한 접근 방식은 사용자 정의 OpenAI 호환 제공자를 제공하는 모든 도구(Zed, JetBrains 플러그인, Neovim 플러그인, 터미널 어시스턴트 및 자체 스크립트)에서 작동합니다. 도구가 고정된 벤더 목록만 허용하는 경우 환경 변수를 확인하세요. 많은 OpenAI 기반 도구는 OPENAI_BASE_URL 및 OPENAI_API_KEY을 읽으며, 이는 셸에서 설정할 수 있습니다:

# base URL https://api.deepseek4api.com/v1, model uncensored
export OPENAI_BASE_URL="https://api.deepseek4api.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
# then select the model name "uncensored" inside the tool

잘 작동하는 것과 그렇지 않은 것

이 API가 코딩 워크플로우에 얼마나 잘 맞는지 알려드립니다.

  • 작동: 코드에 대한 채팅, 오류 설명, 함수 작성, 선택 부분 리팩토링, 테스트 생성, 커밋 메시지 초안 작성, 함수 호출 에이전트 도구.
  • 작동하지 않음: fill-in-the-middle 엔드포인트에 의존하는 인라인 자동 완성. API는 POST /v1/chat/completions 및 GET /v1/models만 노출하므로 레거시 completions 경로가 없습니다. 탭 완성에 의존하는 경우 다른 도구를 유지하세요.
  • 제공되지 않음: 임베딩이므로 코드베이스를 임베딩 모델로 인덱싱하는 확장 프로그램은 별도의 임베딩 소스가 필요합니다. 이미지, 오디오, 비디오 생성 및 파인튜닝도 동일합니다.

이 모델은 합법적인 성인 사용을 거부하지 않는 범용 텍스트 모델입니다. 코딩에 대한 벤치마크 주장은 없으므로 자체 코드로 평가하세요. 코드에는 낮은 temperature(0.2~0.4)를 사용하고 확장 프로그램에 언어 및 스타일에 대한 명확한 지시사항을 제공하세요.

비용 측면에서 파일 컨텍스트 8,000 토큰을 보내고 1,000 토큰의 답변을 받는 코딩 질문에는 8,000 x $0.15 / 1M + 1,000 x $0.50 / 1M가 들며, 이는 $0.0012 + $0.0005, 즉 $0.0017입니다. 근무일 22일 동안 하루 100회면 2,200회 호출 및 $3.74입니다. 가격 책정 페이지에서 충전 단계를 확인하세요.

일반적인 오류 해결

증상잠재적 원인해결 방법
401 또는 인증 오류잘못된 키, 추가 공백 또는 잘못된 필드에 키 붙여넣기키를 다시 복사한 후 curl 테스트를 반복하세요
404 찾을 수 없음Base URL에 /v1이 누락되었거나 후행 경로가 있음정확히 https://api.deepseek4api.com/v1를 사용하세요
모델을 찾을 수 없음모델 이름이 다르게 입력됨소문자로 uncensored를 사용하세요
concurrency 관련 429키가 허용하는 것보다 많은 동시 요청 (일반 키 8개, 체험 키 2개)확장 프로그램의 동시 요청을 줄이거나 기다리세요
rate_limited과 함께 429분당 300개 이상의 요청 (체험 키 60개)에이전트 속도를 줄이거나 단계를 일괄 처리하세요
429 및 Retry-After: 5일시적 과부하5초 후 재시도
요청이 너무 큽니다본문이 8 MB를 초과했습니다컨텍스트로 사용할 파일 수를 줄이거나 크기가 작은 파일을 보내세요

스트리밍 응답은 스트림이 끝날 때까지 동시성 슬롯을 유지하므로, 체험 키로 여러 채팅 창을 동시에 열면 예상보다 빨리 동시성 제한에 도달합니다. 키가 허용하는 내용을 확인하려면 X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency 응답 헤더를 확인하고, 남은 크레딧 금액은 X-Balance-USD 헤더를 확인하세요. 실패한 요청은 요금이 부과되지 않으므로 재시도는 무료입니다.

질문과 답변

VS Code에서 어떤 모델 ID를 입력해야 하나요?

base URL https://api.deepseek4api.com/v1과 API 키를 사용하여 소문자로 uncensored를 입력하세요. 확장 프로그램에서 OpenAI 호환 제공자 유형을 선택하세요.

이것이 공식 DeepSeek V4 API입니까?

아닙니다. 이는 독립적인 제공자가 운영하는 단일 오픈 웨이트 모델이며, DeepSeek 또는 기타 벤더의 공식 API가 아닙니다.

인라인 코드 자동 완성에 사용할 수 있나요?

중간 채우기(fill-in-the-middle) 자동 완성용은 아닙니다. API는 채팅 완료와 모델 목록만 제공합니다. 채팅, 수정 및 에이전트 도구에는 작동합니다.

에이전트 확장 프로그램에서 429 오류가 발생하는 이유는 무엇인가요?

에이전트는 많은 요청을 동시에 보냅니다. 일반 키는 동시 요청 8개와 분당 300개를 허용하며, 체험 키는 동시 2개와 분당 60개를 허용합니다. 병렬성을 줄이거나 Retry-After 지연 후 다시 시도하세요.

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

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