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 요청을 사용합니다.
- 운영 통합 전에 간단한 채팅 완성으로 연결을 테스트합니다.
- 응답 헤더를 모니터링하여 속도 제한 상태와 남은 할당량을 확인합니다.
사용 가능한 모델 및 엔드포인트

| 모델 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 인코딩 데이터를 수용합니다.
사용 사례 및 통합 예시

- 온도 제어 샘플링을 사용하여 마케팅 카피, 블로그 포스트 및 제품 설명을 만드는 콘텐츠 생성 자동화에 활용됩니다.
- 코드 어시스턴트 도구에 DeepSeek Coder V2를 통합하여 자동 완성, 리팩토링 제안 및 버그 감지 기능을 구현합니다.
- API가 연구 논문, 재무 보고서 또는 법률 문서를 처리하고 구조화된 데이터를 추출하는 데이터 분석 파이프라인을 구축합니다.
- 검색을 위한 DeepSeek Embeddings와 근거 기반 생성을 위한 채팅 모델을 결합한 RAG 파이프라인을 구현합니다.


