Deepseek Chat App Try Now

DeepSeek API: 고성능 모델 통합 및 개발자 가이드

OpenAI 호환성, 합리적인 가격, 강력한 모델을 통해 차세대 AI 애플리케이션을 구축하세요.

지금 시작하기

DeepSeek API 개요

DeepSeek API 개요

DeepSeek API는 개발자와 기업이 비용 효율적으로 AI를 통합할 수 있도록 설계된 REST 기반 인터페이스를 통해 DeepSeek의 대규모 언어 모델 제품군에 대한 프로그래밍 방식의 접근을 제공합니다. 이 API는 대화형 AI부터 코드 생성 및 임베딩에 이르기까지 다양한 워크로드에 최적화된 여러 모델 변체를 지원합니다. 특히 OpenAI 호환 엔드포인트를 유지하므로 개발자는 최소한의 코드 수정만으로도 기존 서비스 제공업체를 전환할 수 있습니다.

API 액세스에는 개발자 대시보드에서 생성된 Bearer 토큰을 통한 인증이 필요합니다. Python, Node.js, Go, Java용 공식 SDK가 제공되지만, 모든 HTTP 클라이언트를 통해 REST 엔드포인트와 상호 작용할 수 있습니다. 이 플랫폼은 프로토타입을 제작하는 개인 개발자부터 AI 기능을 확장하려는 스타트업, 그리고 대규모 추론 워크로드를 위해 예측 가능한 가격 책정이 필요한 기업을 대상으로 합니다.

기능 사양
사용 가능 모델 DeepSeek V3, DeepSeek Coder V2, DeepSeek Chat
속도 제한 무료 티어 일일 500K 토큰, 유료 티어 일일 최대 50M 토큰
인증 방법 Bearer 토큰 (API 키)
공식 SDK Python, Node.js, Go, Java
지원 언어 다국어 (70개 이상의 언어, 영어 및 중국어 최적화)

주요 기술적 기능으로는 실시간 애플리케이션을 위한 스트리밍 응답, 도구 통합을 위한 함수 호출(Function Calling), 구조화된 출력을 위한 JSON 모드 등이 있습니다. API는 플래그십 모델 전체에서 최대 128K 토큰의 컨텍스트 창을 처리하므로 긴 문서를 분할하지 않고도 분석할 수 있습니다. 모든 요청은 글로벌 CDN 엔드포인트를 통해 라우팅되며, 대부분의 지역에서 200ms 미만의 평균 지연 시간을 유지합니다.

  • 간편한 마이그레이션을 위해 OpenAI와 호환되는 구조의 REST API를 제공합니다.
  • 채팅 완성, 임베딩, 코드 생성에 대한 네이티브 지원을 포함합니다.
  • 추론 클러스터 전반에 걸친 자동 부하 분산 기능을 갖추고 있습니다.
  • 상세한 사용량 분석 및 토큰 소모 추적 기능을 제공합니다.

API 시작하기

API 시작하기

API 액세스를 설정하려면 먼저 DeepSeek 플랫폼에서 개발자 계정을 생성하고 자격 증명 섹션에서 첫 번째 API 키를 생성해야 합니다. 퀵스타트 과정은 인증 구성, SDK 설치, 첫 번째 요청 실행이라는 세 가지 핵심 단계로 구성됩니다. 대부분의 개발자는 제공된 코드 템플릿을 사용하여 15분 이내에 첫 번째 요청 테스트를 완료할 수 있습니다.

인증은 "sk-"로 시작하는 키와 함께 Bearer 토큰 형식을 사용합니다. 모든 API 엔드포인트의 기본 URL은 RESTful 규칙을 따르는 https://api.deepseek.com/v1 입니다. 필수 헤더에는 API 키가 포함된 Authorization과 application/json으로 설정된 Content-Type이 포함되어야 합니다. 속도 제한은 계정 단위가 아닌 키 단위로 적용되어 팀이 여러 프로젝트에 걸쳐 할당량을 분산할 수 있습니다.

Python SDK 설치를 위해 pip를 사용하여 공식 클라이언트 라이브러리를 추가하십시오. 다음 코드는 DeepSeek V3를 사용하여 채팅 완성 엔드포인트를 활용하는 완전한 첫 번째 요청 워크플로를 보여줍니다.

pip install deepseek-sdk
from deepseek import DeepSeek

client = DeepSeek(api_key="sk-your-api-key-here")

response = client.chat.completions.create(
    model="deepseek-chat-v3",
    messages=[
        {"role": "system", "content": "당신은 유능한 비서입니다."},
        {"role": "user", "content": "양자 컴퓨팅을 쉬운 용어로 설명해 주세요."}
    ],
    max_tokens=500,
    temperature=0.7
)

print(response.choices[0].message.content)

SDK 의존성 없이 테스트하려는 개발자를 위해 curl을 사용한 HTTP 요청 예제도 제공됩니다. 이 방식은 헤더 구성을 직접 제어해야 하는 환경에서 유용합니다.

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat-v3",
    "messages": [{"role": "user", "content": "안녕하세요, API!"}],
    "max_tokens": 100
  }'
  • 개발자 대시보드 보안 탭에서 API 키 설정을 확인합니다.
  • Python SDK를 설치하거나 언어 유연성을 위해 직접 HTTP 요청을 사용합니다.
  • 운영 통합 전에 간단한 채팅 완성으로 연결을 테스트합니다.
  • 응답 헤더를 모니터링하여 속도 제한 상태와 남은 할당량을 확인합니다.

API 가격 및 속도 제한

API 가격 및 속도 제한

현재 2026년 기준으로 DeepSeek API 가격은 입력 및 출력 토큰에 대해 별도로 과금되는 토큰 기반 모델을 따르며, 비용은 모델의 성능에 따라 달라집니다. 플래그십 모델인 DeepSeek V3의 비용은 입력 토큰 100만 개당 $0.27, 출력 토큰 100만 개당 $1.10로 설정되어 경쟁사 모델에 비해 매우 경제적입니다. 신규 계정에는 총 $5의 무료 크레딧이 제공됩니다.

모델 입력 (1M 토큰당) 출력 (1M 토큰당) 컨텍스트 창 속도 제한 (토큰/분)
DeepSeek V3 $0.27 $1.10 128K 90,000
DeepSeek Chat $0.14 $0.28 64K 150,000
DeepSeek Coder V2 $0.14 $0.28 64K 120,000
DeepSeek Embeddings $0.002 N/A 8K 200,000

사용 요금은 요청당 자동 차감되는 선불 크레딧 시스템으로 운영됩니다. 대시보드에는 모델 및 프로젝트별로 실시간 소비 지표가 표시되며, 예상치 못한 초과 사용을 방지하기 위해 설정 가능한 지출 알림 기능을 제공합니다.

사용 가능한 모델 및 엔드포인트

사용 가능한 모델 및 엔드포인트

모델 ID 유형 컨텍스트 창 주요 사용 사례
deepseek-chat-v3 Chat Completion 128K 토큰 대화형 AI, 일반 추론, 다국어 대화
deepseek-coder-v2 Code Completion 64K 토큰 코드 생성, 디버깅, 기술 문서 작성
deepseek-reasoner Chat Completion 128K 토큰 복잡한 문제 해결, 연쇄 사고 추론
deepseek-embed Embeddings 8K 토큰 시맨틱 검색, RAG 파이프라인, 유사성 매칭
deepseek-vision-preview Multimodal (Beta) 32K 토큰 + 이미지 이미지 분석, OCR, 시각적 질의응답
  • 채팅 모델은 실시간 UX를 위해 stream 파라미터를 통한 스트리밍 응답을 지원합니다.
  • 코드 완성 모델에는 Python, JavaScript, Java, C++, Go용 언어별 최적화가 포함되어 있습니다.
  • 임베딩 모델 리스트는 시맨틱 작업을 위해 1024차원의 벡터를 반환합니다.
  • 비전 모델(베타)은 텍스트 프롬프트와 함께 이미지 URL 또는 base64 인코딩 데이터를 수용합니다.

자주 묻는 질문 (FAQ)

DeepSeek API는 OpenAI와 호환되나요?

네, DeepSeek API는 OpenAI 호환 엔드포인트를 제공하여 최소한의 코드 수정으로 쉽게 마이그레이션할 수 있습니다.

DeepSeek V3의 API 가격은 얼마인가요?

입력 토큰 100만 개당 $0.27, 출력 토큰 100만 개당 $1.10로 매우 경제적입니다.

신규 사용자에게 무료 크레딧이 제공되나요?

네, 신규 계정 등록 시 $5의 테스트용 무료 크레딧이 제공됩니다.

지원되는 공식 SDK는 무엇인가요?

Python, Node.js, Go, Java용 공식 SDK를 제공합니다.

API의 최대 컨텍스트 창 크기는 얼마인가요?

플래그십 모델인 V3의 경우 최대 128K 토큰의 컨텍스트 창을 지원합니다.

실시간 응답을 위한 스트리밍을 지원하나요?

네, stream 파라미터를 통해 서버 전송 이벤트(SSE) 방식의 스트리밍 응답이 가능합니다.

코드 생성을 위한 전용 모델이 있나요?

네, 코드 완성 및 디버깅에 최적화된 DeepSeek Coder V2 모델이 준비되어 있습니다.

API 사용을 위해 선불 결제가 필요한가요?

네, 선불 크레딧 시스템으로 운영되며 대시보드에서 실시간 사용량을 확인할 수 있습니다.

함수 호출(Function Calling)이 가능한가요?

네, 도구 통합을 위한 함수 호출 및 구조화된 출력을 위한 JSON 모드를 지원합니다.

속도 제한(Rate Limit)은 어떻게 되나요?

무료 계정은 일일 500K 토큰이며, 유료 티어는 사용량에 따라 최대 일일 50M 토큰까지 확장됩니다.