Python에서 DeepSeek API를 사용하는 방법 — 초보자 가이드 (2026)

모두가 "DeepSeek는 정말 저렴하다"라고 말하지만, 대부분의 튜토리얼은 곧바로 고급 내용으로 넘어갑니다. 그래서 여기 제가 첫날에 가졌으면 좋았을 버전을 준비했습니다. 사전 경험 없이도 제로(zero) 상태에서 첫 번째 API 호출을 성공할 때까지 안내합니다.

DeepSeek가 배우기 좋은 첫 번째 API인 두 가지 이유:

1. 저렴합니다. 미국의 대형 모델들보다 무려 한 자릿수(an order of magnitude)나 더 저렴합니다. 비용 걱정 없이 하루 종일 실험할 수 있습니다.
2. OpenAI와 호환됩니다 (OpenAI-compatible). OpenAI의 Python 코드를 본 적이 있다면, 이미 사용법을 알고 있는 것이나 다름없습니다. 단 두 줄만 바꾸면 됩니다. 따라서 이 기술은 어디에서나 전이될 수 있습니다.

이제 작동하는 호출을 만들어 봅시다.

1단계 — API 키 가져오기

platform.deepseek.com에 접속하여 가입한 후, API Keys 페이지를 열고 새 키를 생성하세요. 생성 즉시 복사해 두어야 합니다. 키는 한 번만 보여주기 때문입니다. 그런 다음 코드에 직접 붙여넣는 대신 환경 변수(environment variable)로 저장하세요:

export DEEPSEEK_API_KEY="your_key_here"

(GitHub에 푸시할 수도 있는 파일에 키를 하드코딩(hardcode)하지 마세요. 사람들은 유출된 키를 찾아내기 위해 스크래핑을 합니다.)

2단계 — SDK 설치

pip install openai

네, 맞습니다. OpenAI SDK입니다. DeepSeek는 동일한 프로토콜을 사용하므로 이를 재사용합니다.

3단계 — 첫 번째 호출

import os
from openai import OpenAI

...

끝입니다. 이것을 "OpenAI"가 아닌 "DeepSeek"로 만드는 유일한 요소는 base_url과 model뿐입니다. 그 외의 모든 것은 동일합니다.

Python 사용자가 아니신가요? (curl)

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
...

저를 놀라게 한 부분: 가격

DeepSeek V4 Flash는 입력 토큰 100만 개당 약 $0.14, 출력 토큰 100만 개당 약 $0.28로 실행됩니다. 100만 토큰은 대략 750,000단어에 해당합니다. 따라서 하루 종일 집중적으로 실험해도 비용은 달러가 아닌 센트(cents) 단위로 발생합니다.

비교하자면, 플래그십 GPT 및 Claude 모델의 출력 비용은 이보다 10배 이상 더 비쌀 수 있습니다. 학습, 사이드 프로젝트, 그리고 솔직히 말해 대부분의 프로덕션 워크로드 (production workloads)에 있어 저렴한 티어 (cheap tier)는 진정으로 충분히 훌륭합니다. (캐시 히트 (Cache hits)는 입력 가격의 1/10로 청구되는데, 프롬프트 (prompts)를 재사용할 경우 비용 절감 효과가 매우 빠르게 나타납니다.)

초보자가 주의해야 할 몇 가지 사항

• 모델 이름으로 deepseek-v4-flash를 사용하세요. 기존의 deepseek-chat 별칭 (alias)은 여전히 작동하지만 2026년 7월 24일에 폐지될 예정입니다. 많은 오래된 튜토리얼들이 여전히 이를 사용하고 있습니다.
• 사용하기 전에 약간의 크레딧 (credit)을 충전해야 합니다. 무제한 무료 티어 (free tier)는 없습니다.
• "OpenAI 호환 (OpenAI-compatible)"이 곧 OpenAI인 것은 아닙니다. 몇몇 니치한 파라미터 (parameters)가 다르지만, 위의 기본 사항들은 동일합니다.
• API 키를 git에 올리지 마세요. 두 번 말할 가치가 있을 정도로 중요합니다.

마무리

이제 여러분은 작동 가능한 매우 저렴한 AI API와 거의 모든 다른 모델로 전이 가능한 코드를 갖게 되었습니다. 이제 무언가를 만들어 보세요.

여러분은 무엇을 만들고 계신가요? 그리고 만약 미국 이외의 지역에 계신다면 — 설정 과정이 쉬웠나요, 아니면 결제나 가입 단계가 어려웠나요? 그런 경우가 얼마나 흔한지 궁금합니다.