DeepSeek 사용법: 웹·앱 체험부터 API 연동까지

웹에서 바로 체험하기

가장 간단한 시작점은 DeepSeek 공식 홈페이지입니다. 홈페이지의 Start Now는 DeepSeek를 웹에서 체험하는 경로이고, 같은 화면에서 API 접근과 앱 다운로드로도 이동할 수 있습니다. 별도 개발 환경 없이 모델의 답변 스타일을 먼저 확인하려면 웹 체험부터 시작하는 것이 가장 빠릅니다.

웹이나 앱이 느리거나 정상 동작하지 않는다고 느껴지면 DeepSeek 서비스 상태 페이지를 확인하세요. 해당 페이지는 Web/APP 성능 이상처럼 조사·해결된 이슈를 게시합니다.

모바일 앱으로 사용하기

DeepSeek 앱 공지는 앱스토어에서 DeepSeek를 검색하거나 공식 웹사이트의 직접 링크를 이용하라고 안내합니다. 같은 공지는 사용자가 잘못된 경로로 설치하지 않도록 공식 채널에서만 다운로드하라고 강조합니다.

비용 표기는 앱과 API를 나눠 봐야 합니다. 앱 공지는 100% FREE - No ads, no in-app purchases라고 설명하지만, API 사용 비용은 별도의 Models & Pricing 문서에서 확인해야 합니다.

API 연동: 첫 호출까지의 흐름

개발자가 준비할 것은 단순합니다. 먼저 DeepSeek API 키를 만들고, 요청 헤더에 Authorization: Bearer <TOKEN> 형식의 Bearer 인증을 넣습니다. DeepSeek 문서는 API 형식이 OpenAI와 호환되므로 OpenAI SDK나 OpenAI API 호환 소프트웨어에서 설정을 바꿔 접근할 수 있다고 설명합니다.

채팅 응답을 만드는 기본 엔드포인트는 /chat/completions입니다. 이 엔드포인트는 지금까지의 대화를 담은 messages 배열을 요청 본문에 넣어 모델 응답을 생성합니다.

HTTP 요청 뼈대

아래 예시는 구조를 이해하기 위한 템플릿입니다. <DEEPSEEK_BASE_URL>에는 공식 Quick Start의 base_url 값을 넣고, <MODEL_ID>에는 Models & Pricing 또는 List Models에서 확인한 모델명을 넣으세요.

POST <DEEPSEEK_BASE_URL>/chat/completions
Authorization: Bearer <DEEPSEEK_API_KEY>
Content-Type: application/json

{
  "model": "<MODEL_ID>",
  "messages": [
    {
      "role": "user",
      "content": "DeepSeek를 한 문단으로 설명해줘."
    }
  ]
}

DeepSeek Quick Start는 OpenAI 호환성을 위한 v1 표기가 모델 버전과 관계없다고 설명하므로, URL 경로의 표기와 실제 모델 버전을 혼동하지 않는 것이 좋습니다.

Python으로 한 번 호출해 보기

DeepSeek 공식 가이드의 예제들은 OpenAI(api_key=..., base_url=...)로 클라이언트를 만들고 client.chat.completions.create를 호출하는 형태를 사용합니다. 환경변수에 API 키, base URL, 모델명을 넣어 두면 다음처럼 첫 호출 구조를 확인할 수 있습니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['DEEPSEEK_API_KEY'],
    base_url=os.environ['DEEPSEEK_BASE_URL'],
)

response = client.chat.completions.create(
    model=os.environ['DEEPSEEK_MODEL'],
    messages=[
        {
            'role': 'user',
            'content': 'DeepSeek를 한 문단으로 설명해줘.',
        }
    ],
)

print(response.choices.message.content)

모델명은 최신 문서에서 다시 확인하기

API 예제의 모델명을 그대로 복사하기 전에는 공식 문서를 한 번 더 확인하세요. Quick Start는 deepseek-chat과 deepseek-reasoner를 DeepSeek-V3.2와 연결해 설명하지만, Change Log는 current period에 두 이름이 각각 deepseek-v4-flash의 비추론 모드와 추론 모드를 가리킨다고 안내합니다.

따라서 새 프로젝트나 운영 환경에서는 블로그 예제나 오래된 별칭보다 공식 Models & Pricing과 List Models를 기준으로 모델명을 확정하는 편이 안전합니다.

개인정보와 업무 자료 입력 전 확인할 점

개인정보처리방침은 DeepSeek 앱, 웹사이트, 소프트웨어 및 관련 서비스에 적용된다고 설명합니다. 이용약관도 별도로 제공됩니다. 고객 정보, 비공개 코드, 사내 문서처럼 민감한 자료를 입력하기 전에는 이 문서들과 조직의 데이터 처리 기준을 함께 검토하는 것이 좋습니다.

앱 설치 역시 공식 경로를 우선하세요. DeepSeek 앱 공지는 오해를 피하기 위해 공식 채널에서만 다운로드하라고 안내합니다.

문제가 생길 때 체크리스트

• 인증 오류: API 키를 만들었는지, Authorization: Bearer <TOKEN> 형식으로 보냈는지 확인합니다.
• 모델명 오류: Models & Pricing 또는 List Models에서 현재 사용 가능한 모델명을 다시 확인합니다.
• 웹·앱 성능 이상: DeepSeek 서비스 상태 페이지에서 Web/APP 관련 이슈가 있는지 확인합니다.
• 앱 다운로드 혼선: 앱스토어 검색 또는 공식 웹사이트 링크처럼 앱 공지가 안내한 공식 채널을 사용합니다.
• 비용 착각: 앱 공지의 무료 안내와 API 과금 문서는 별개로 봐야 합니다.

마무리

일반 사용자는 공식 홈페이지의 웹 체험이나 공식 앱으로 가장 빨리 시작할 수 있습니다. 개발자는 API 키를 만든 뒤 Bearer 인증과 OpenAI 호환 /chat/completions 호출로 첫 연동을 확인하면 됩니다. 실제 프로젝트에 넣기 전에는 모델명, 요금, 개인정보 처리 기준을 공식 문서에서 다시 확인하세요.