DeepSeek API URL 및 Base URL: 전환 방법
DeepSeek의 자체 문서에서 복사한 deepseek api url은 Base URL이며, DeepSeek의 키와 DeepSeek의 모델에서만 작동합니다. 다른 OpenAI 스타일 엔드포인트를 사용하려면 해당 URL, 키 및 모델 ID를 변경하세요.
업데이트
주요 포인트
- Base URL은 접두사 역할을 하며, SDK는 여기에 /chat/completions을 추가합니다.
- 이 서비스는 https://api.getdeepseekapi.com/v1를 모델 ID uncensored와 함께 사용합니다.
- DeepSeek의 API가 아니므로 DeepSeek 키는 여기서 작동하지 않으며 그 반대도 마찬가지입니다.
- 대부분의 클라이언트는 OPENAI_BASE_URL 및 OPENAI_API_KEY를 통해 URL과 키도 허용합니다.

Base URL, 엔드포인트 및 경로: 세 부분
접두어가 필요한 필드에 전체 주소를 붙여넣어 404 오류를 자주 겪습니다. 이 세 용어를 명확히 구분하면 문제를 피할 수 있습니다.
- Base URL: 모든 호출의 공유 접두사입니다. 예를 들어
https://api.getdeepseekapi.com/v1입니다. 이는 클라이언트의 "API base" 또는 "Base URL" 설정에 입력하는 값입니다. - 엔드포인트 경로: SDK가 추가하는 부분으로, 예를 들어
/chat/completions,/responses또는/models이 있습니다. - 전체 URL: Base URL에 경로를 더한 형태입니다. 예를 들어
https://api.getdeepseekapi.com/v1/chat/completions와 같습니다. curl과 같은 원시 HTTP 클라이언트는 이 전체 URL이 필요합니다.
대부분의 사람이 실수하는 규칙: SDK와 앱은 base URL을 요청하고, curl과 HTTP 노드는 전체 URL을 요청합니다. 404 오류가 발생하면 base가 필요한 곳에 전체 URL을 넣었거나 그 반대의 경우인지 먼저 확인하세요. 오류 메시지에 /v1/chat/completions/chat/completions와 같이 경로가 두 번 나타나는 것이 그 단서입니다.
DeepSeek Base URL의 정의와 비정의
DeepSeek는 문서에 자체 API 주소와 키가 사용할 수 있는 모델 이름을 게시합니다. 블로그 글(이 글 포함)을 믿기보다는 문서에서 현재 값을 확인하세요. DeepSeek 키는 DeepSeek의 엔드포인트에서만 작동하며 다른 곳에서는 작동하지 않습니다.
이 사이트의 서비스는 별도 제품입니다. 공식 DeepSeek API가 아니며 DeepSeek으로 포워딩하지 않고 DeepSeek 모델을 제공하지 않습니다. 이 서비스는 독립적인 제공자가 운영하고 법적인 성인 사용에 콘텐츠 거부 없이 응답하도록 조정된 오픈 웨이트 모델 하나를 위한 호스팅된 OpenAI 호환 API입니다. 주소는 다음과 같습니다:
https://api.getdeepseekapi.com/v1 # model: uncensored
모델 ID는 uncensored이며, 인증은 Authorization: Bearer <key>입니다. 키는 API 키 페이지에서 발급됩니다. 각 서비스에 대한 키의 의미를 비교하는 경우, DeepSeek API 키 페이지에 더 많은 세부 정보가 있습니다.
OpenAI SDK에서 엔드포인트 전환
Base URL과 키를 변경하면 모든 OpenAI SDK가 작동합니다. Python에서는 다음과 같습니다:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
Node.js에서는 필드명이 baseURL로 표기됩니다:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
차이점에 유의하세요: Python은 base_url을 사용하고, Node는 baseURL을 사용합니다. 이들을 혼동하면 기본 OpenAI 주소로 전환되어 키가 거부됩니다.
코드 수정 없이 전환
공식 OpenAI SDK는 두 개의 환경 변수를 읽으므로 기존 앱은 코드 변경 없이 지시 대상을 변경할 수 있습니다:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
모델 이름은 생략할 수 없는 부분입니다. 앱이 다른 모델 ID를 하드 코딩하면 해당 모델을 요청하여 실패하므로 앱의 설정 또는 구성에서 uncensored로 변경하세요. 많은 도구는 API base, API key 및 model이라는 레이블로 이 세 값을 하나의 설정 화면에 노출합니다.
동일한 세 값 교체는 프레임워크에서도 작동합니다. 예를 들어 Python의 LangChain에서는 ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored")로 충분합니다. OpenAI 호환 엔드포인트를 허용하는 코딩 도구도 동일한 방식으로 작동합니다. 코딩용 API 사용 가이드를 참조하세요.
Raw HTTP: 정확한 경로
curl, 스크립트 및 사용자가 빌드한 HTTP 노드의 경우 전체 URL을 직접 구성합니다. 이 서비스의 경로는 다음과 같습니다:
| 목적 | 메서드 및 URL |
|---|---|
| 채팅 | POST https://api.getdeepseekapi.com/v1/chat/completions |
| 응답 API | POST https://api.getdeepseekapi.com/v1/responses |
| 모델 목록 | GET https://api.getdeepseekapi.com/v1/models |
| 잔액 | GET https://api.getdeepseekapi.com/v1/balance |
| 잔액, OpenAI 스타일 | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
HTTPS만 사용하세요. 스트리밍은 서버 전송 이벤트(SSE)를 통해 "stream": true로 작동하며, 동일한 URL이 두 모드 모두를 제공합니다.
설정 화면이 있는 앱에 URL 입력
많은 채팅 프론트엔드, 편집기 및 자동화 도구에는 "사용자 정의 OpenAI 호환 엔드포인트" 옵션이 있습니다. 레이블은 다르지만 필드는 일대일로 매핑됩니다:
| 앱의 필드 | 내용 |
|---|---|
| API 베이스, 베이스 URL, 엔드포인트, 서버 URL | https://api.getdeepseekapi.com/v1 |
| API key, Token, Secret | 이 서비스에서 발급받은 키 |
| 모델, 모델 이름, 모델 ID | uncensored |
일부 앱은 Base URL 대신 전체 채팅 URL을 요구합니다. 그런 경우 https://api.getdeepseekapi.com/v1/chat/completions를 사용하세요. 앱에 "연결 테스트" 버튼이 있는 경우 일반적으로 모델 목록을 호출하며, 이는 GET /v1/models입니다. 버튼이 실패하지만 수동 채팅이 작동하면 앱의 확인이 API보다 엄격하므로 무시할 수 있습니다.
URL만으로 간단한 검증을 수행합니다.
앱을 디버깅하기 전에 모델 목록으로 URL을 먼저 검증하세요. 본문이 필요 없으며 비용도 들지 않습니다:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
data 배열이 포함된 JSON 응답을 받아야 합니다. HTML 오류 페이지가 반환되면 호스트나 경로가 잘못되었음을 의미합니다. 예를 들어 서브도메인이 누락된 경우입니다. 호스트는 api.로 시작해야 하며, www.이 아닙니다.
자주 발생하는 실수 수정
- 404 Not Found. 베이스 URL에
/v1이 누락되었거나, 두 번 포함되어 있거나, 엔드포인트 경로가 포함되어 있습니다. - 401 또는 인증 오류입니다. 다른 서비스의 키를 사용했거나, 헤더에
Bearer이 빠져 있습니다. 키는 공급자 간에 서로 바꿔 사용할 수 없습니다. - 모델을 찾을 수 없음. 요청에서 여전히 이전 공급자의 모델을 지명하고 있습니다.
uncensored로 설정하세요. - 앱이 여전히 이전 서비스와 통신합니다. 일부 도구는 설정을 캐시하거나 다른 변수를 읽습니다. 프로세스를 다시 시작하고 설정 화면을 확인하세요.
- 후행 슬래시 문제입니다. 대부분의 클라이언트는 이를 견디지만, 그렇지 않은 경우 베이스 URL의 마지막 슬래시를 제거하세요.
어느 쪽에서 오류가 발생했는지 확실하지 않다면 위의 curl 명령을 보내세요. 200 응답은 URL, 키 및 모델이 올바름을 증명합니다. 나머지 오류는 모두 앱에서 발생합니다. 문서에는 한도 및 X-Request-Id과 같은 헤더가 나열되어 있어 지원 문의 시 도움이 됩니다.
전환 후에도 변하지 않는 사항
요청 및 응답 구조는 OpenAI 형식을 따르므로 메시지 배열, temperature, top_p, stop, seed, 패널티, 도구 호출 및 JSON 모드가 평소와 동일하게 작동합니다. 컨텍스트 창은 프롬프트와 completion을 합쳐 100,000 토큰이며, 최대 요청 본문 크기는 8 MB입니다. 텍스트 전용 서비스이므로 이미지, 오디오, 임베딩 또는 파인튜닝으로 구축된 기능이 필요하면 다른 공급자를 사용해야 합니다.
과거 제공업체와도 요금이 별도입니다: 선불 크레딧 기준 입력 토큰 100만 토큰당 $0.15, 출력 토큰 100만 토큰당 $0.50입니다. 가격 책정 페이지에 표시됩니다. 새 사용자는 아무것도 결제하기 전에 전환이 정상적으로 작동하는지 확인하기 위해 $0.50의 무료 체험 크레딧을 청구할 수 있습니다.
더 많은 가이드
질문과 답변
DeepSeek API 베이스 URL은 무엇인가요?
DeepSeek는 자체 문서에 이를 게시하므로 거기서 현재 값을 확인하세요. 이 사이트의 엔드포인트는 https://api.getdeepseekapi.com/v1에 있는 다른 서비스입니다.
이 엔드포인트에서 DeepSeek 키를 사용할 수 있나요?
아니요. 키는 서비스별로 발급됩니다. 키 페이지에서 이 API용 키를 얻고, 모델을 uncensored로 설정하세요.
베이스 URL이 /v1로 끝나야 하나요?
이 서비스의 경우 예: https://api.getdeepseekapi.com/v1. SDK는 그 뒤에 엔드포인트 경로를 추가하므로 /chat/completions을 직접 추가하지 마세요.
URL을 변경한 후 404가 발생하는 이유는 무엇인가요?
보통 경로가 두 번 붙거나 /v1이 누락됩니다. 위의 정확한 값과 베이스 URL을 비교하세요.
키를 받기 위해 양식 하나만 필요합니다
계정을 생성하고, 키를 복사하고, 베이스 URL을 변경하세요. 설정은 이것으로 끝입니다.