KO ▾
API 키 받기

deepseek4api.com가이드

DeepSeek API 문서 가이드 및 대체 API

DeepSeek API 문서를 살펴보는 대부분의 사람들은 같은 다섯 가지 답변을 원합니다: base URL, 인증 방법, 사용할 모델 이름, 작동하는 파라미터, 그리고 작동하는 호출 예시입니다. 이 페이지에서는 이러한 내용을 다루고, 교체할 수 있는 다른 OpenAI 호환 엔드포인트로 동일한 호출을 수행하는 방법을 보여줍니다.

업데이트

빛나는 코드 블록으로 연결된 두 개의 일치하는 커넥터 플러그인, 대체 API 교체 표시
서버로 연결되는 서로 다른 높이의 두 코인 스택, 입력 및 출력 토큰 가격 표시

주요 포인트

  • DeepSeek는 OpenAI 스타일의 API를 문서화하고 있으므로, base URL, 키 및 모델 이름을 변경하면 OpenAI SDK가 작동합니다.
  • 이 사이트는 DeepSeek의 공식 API가 아니며, uncensored ID의 단일 독립 오픈 웨이트 모델을 제공합니다.
  • 동일한 코드가 둘 다에서 작동합니다: 변경되는 값은 세 가지뿐입니다.
  • 여기서 컨텍스트 창은 100,000 토큰이며, 스트리밍, 도구 및 JSON 모드가 지원됩니다.

DeepSeek API 문서가 답변하는 다섯 가지 항목

개발자가 deepseek api docs를 검색할 때 일반적으로 첫 번째 요청을 완료하려고 합니다. 패턴은 모든 OpenAI 호환 서비스와 동일하므로 표를 통해 비교하기가 쉽습니다.

질문DeepSeek 문서이 API
기본 URL빠른 시작(api.deepseek.com)에 문서화됨https://api.deepseek4api.com/v1
인증Authorization 헤더의 Bearer 토큰Authorization 헤더의 Bearer 토큰
모델 이름모델 문서에 나열됨; 현재 이름 확인uncensored
주요 엔드포인트채팅 완성채팅 완성 생성, 응답, 모델 목록
요금현재 가격 확인입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50

모델, 가격 및 제한에 대한 내용은 DeepSeek의 자체 페이지를 참조하십시오. 그들은 변경되며 이 기사는 이를 다시 설명하려는 것이 아닙니다. 핵심은 요청 형태가 공유되므로 두 서비스 간 이동이 구성 변경에 불과하다는 것입니다.

명확히 할 점은 이 사이트는 DeepSeek의 공식 API가 아니며, DeepSeek로 라우팅하는 라우터도 아니라는 것입니다. 이는 독립적인 제공자가 운영하고 합법적인 성인 사용자를 위해 콘텐츠 거부 없이 답변하도록 튜닝된 단일 오픈 웨이트 모델을 제공하는 호스팅된 OpenAI 호환 엔드포인트입니다.

단계 1: 인증 및 베이스 URL

계정을 생성하고(구글 또는 이메일과 비밀번호) API 키 페이지를 엽니다. 키를 복사합니다. 신규 사용자는 원클릭으로 7일 유효하며 카드가 필요 없는 $0.50의 무료 체험 크레딧을 받을 수 있습니다.

모든 요청에는 Authorization: Bearer YOUR_KEY 헤더가 포함됩니다. curl 사용:

curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

이것은 사용 가능한 모델 uncensored을 나열합니다. DeepSeek 예시를 복사할 경우 다음 세 가지만 변경하면 됩니다: 베이스 URL, 키 및 모델 이름. 그 외에는 변경할 것이 없습니다.

단계 2: Python 채팅 완료

OpenAI SDK는 DeepSeek 문서의 예제에서 사용하며, 여기서는 변경 없이 작동합니다:

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain idempotency in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

temperature, top_p, stop, seed 및 존재 및 빈도 페널티를 포함한 지원되는 샘플링 파라미터가 전달됩니다. max_tokens는 옵션입니다. 완료 시 100,000 토큰 창에 남은 부분을 사용할 수 있기 때문입니다.

3단계: 스트리밍, JSON 모드 및 도구

스트리밍

서버 전송 이벤트를 받기 위해 stream: true를 설정하세요. 사용량은 스트림 끝에 보고됩니다.

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about caching." }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

JSON 모드

response_format: {"type": "json_object"}를 전달하고 프롬프트에 JSON을 언급하세요. 출력은 직접 구문 분석할 수 있는 JSON 객체입니다.

함수 호출

tools 및 tool_choice 매개변수는 OpenAI 형식으로 작동하며, 도구 호출은 델타로 스트리밍되고 role: "tool"로 메시지 형태로 결과를 반환합니다. DeepSeek에 함수 호출을 수행하는 코드가 있다면 위의 세 값 변경으로 이식할 수 있지만 자체 스키마를 테스트하세요.

두 서비스의 차이점

동일한 프로토콜이 동일한 서비스를 의미하지는 않습니다. 워크로드를 이동할 때 확인할 사항:

  • 모델 동작. 다른 모델은 다른 답변, 추론 스타일 및 거부 동작을 제공합니다. 프로덕션에서 변경하기 전에 프롬프트 세트를 다시 실행하세요.
  • 추론 전용 필드. 특정 DeepSeek 모델의 벤더별 응답 필드에 의존하는 경우, 여기에 해당 필드가 존재한다고 가정하지 마세요. 표준 채팅 완료 필드는 존재합니다.
  • 제공되지 않는 기능. 이 API는 텍스트 전용입니다: 이미지, 오디오, 비디오, 임베딩 또는 파인튜닝 없음.
  • 제한 사항. 전체 키는 동시 8개 요청과 분당 300개를 허용합니다. 체험 키는 동시 2개와 분당 60개를 허용합니다. 제한을 초과하면 HTTP 429 오류와 함께 rate_limited 또는 concurrency 오류가 반환됩니다.
  • 잔액. GET /v1/balance, OpenAI 스타일 크레딧 할당 경로 또는 각 응답의 X-Balance-USD 헤더를 통해 크레딧을 확인하세요.

DeepSeek 중심 사용자의 비용 관점을 보려면 DeepSeek 가격 참고 자료를 참조하세요. 편집기 설정의 경우 VS Code 가이드를 참조하세요.

여기서 호출 비용

선불 크레딧 및 토큰 단위 과금: 입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50. 입력 토큰 1,500개 및 출력 토큰 600개로 구성된 요청의 비용은 입력 1,500 x $0.15 / 1M = $0.000225, 출력 600 x $0.50 / 1M = $0.0003으로 총 $0.000525입니다. $20 충전으로 약 38,000회 호출을 처리할 수 있습니다.

충전은 $20부터 $500까지 정수 금액으로 가능하며, $50부터 +5%, $100부터 +10%, $200부터 +15%의 보너스를 제공합니다. 암호화폐(TRC20 기반 USDT, Base 기반 USDC)로 결제할 수 있습니다. 크레딧은 만료되지 않으며, 실패하거나 거부된 요청에는 요금이 부과되지 않습니다. 가격 책정 페이지에서 자세히 확인하세요.

이전 체크리스트

이미 DeepSeek와 통신하는 앱을 포팅한다면 다음 순서로 진행하세요. 각 단계는 몇 분 정도 소요됩니다.

  1. 세 가지 값을 구성에 입력하세요. 베이스 URL, 키 및 모델 이름은 코드에 흩어진 상수가 아닌 환경 변수에서 가져와야 합니다.
  2. 스모크 테스트를 실행하세요. 채팅 완성 생성 하나, 스트리밍 완성 생성 하나, JSON 모드 호출 하나 및 함수 호출 하나입니다. 위의 네 가지 코드 스니펫이 이를 다룹니다.
  3. 실제 프롬프트를 다시 실행하세요. 로그에서 30개의 프롬프트를 가져와 답변을 나란히 비교하세요. 일반적인 점수보다 자체 기준에 따라 평가하세요.
  4. 429 오류를 처리하세요. 백오프와 함께 재시도를 추가하고 Retry-After를 준수하세요. 스트리밍 요청은 스트림이 끝날 때까지 동시성 슬롯을 유지하므로 중단된 스트림을 닫으세요.
  5. 비용을 모니터링하세요. 각 응답에서 usage을 로깅하고 하루 트래픽 동안 X-Balance-USD 헤더와 비교하세요.
  6. 점진적으로 출시하세요. 먼저 새 엔드포인트로 트래픽의 5~10%를 보내고 그 후 증가시키세요.

서로 다른 모델이 동일한 작업에 서로 다른 수의 토큰을 사용하므로 토큰당 가격이 아닌 작업당 비용을 비교하십시오. 허용적인 작성 모델의 동작을 확인하기 위한 오픈 엔드 체크에는 롤플레이 글이 유용한 참고 자료입니다.

두 옵션 간 선택

DeepSeek 모델, 벤더별 기능 또는 공식 지원이 필요할 때 DeepSeek 자체 API를 사용하세요. 콘텐츠 거부 없이 합법적인 성인 사용에 답변하는 호스팅된 OpenAI 호환 모델, 간단한 선불 과금 및 학습에 사용되지 않는 프롬프트를 원한다면 이 엔드포인트를 사용하세요. 많은 팀이 공유 프로토콜로 인해 구성 스위치 뒤에 둘 모두를 원할 것입니다. 이 API의 참고 자료는 문서에 있습니다.

질문과 답변

이것은 공식 DeepSeek API인가요?

아니요. uncensored ID의 단일 오픈 웨이트 모델을 제공하는 독립적인 OpenAI 호환 엔드포인트입니다. DeepSeek의 서비스가 아니며, DeepSeek로 라우팅하지도 않습니다.

DeepSeek 코드를 재사용할 수 있나요?

OpenAI SDK나 채팅 완료 형식을 사용한다면 일반적으로 가능합니다. 베이스 URL, 키 및 모델 이름을 변경한 후 프롬프트를 테스트하세요.

모델 이름은 어디에서 찾나요?

GET /v1/models를 호출하세요. 이 API는 ID가 uncensored인 단일 모델을 제공합니다.

컨텍스트 창은 얼마나 됩니까?

프롬프트와 결과 생성을 위해 100,000개의 토큰.

Authorization 헤더의 Bearer 토큰

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