DeepSeek API 입문 가이드: 빠른 시작 튜토리얼

DeepSeek API 개요

DeepSeek API는 OpenAI와 호환되는 API 형식을 채택하고 있어, 간단한 설정 수정만으로 OpenAI SDK 또는 OpenAI API와 호환되는 모든 소프트웨어를 사용하여 DeepSeek API에 접근할 수 있습니다. 이 가이드는 DeepSeek API를 빠르게 시작하는 데 도움을 드릴 것입니다.

기본 설정 매개변수

주요 설정 매개변수는 다음과 같습니다:

base_url: https://api.deepseek.com
- OpenAI와의 호환성을 위해 https://api.deepseek.com/v1도 사용 가능
- 참고: 여기서 v1은 모델 버전과 무관함
api_key: API 키 신청 필요
model: deepseek-chat을 사용하면 최신 DeepSeek-V3 모델 호출 가능

API 호출 예제

curl 사용 예제

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <DeepSeek API Key>" \
  -d '{
        "model": "deepseek-chat",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "stream": false
      }'

Python SDK 사용 예제

from openai import OpenAI

client = OpenAI(api_key="<DeepSeek API Key>", base_url="https://api.deepseek.com")

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "Hello"},
    ],
    stream=False
)

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

Node.js SDK 사용 예제

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.deepseek.com",
  apiKey: "<DeepSeek API Key>",
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: "system", content: "You are a helpful assistant." }],
    model: "deepseek-chat",
  });

  console.log(completion.choices[0].message.content);
}

main();

주요 안내사항

사용 시작 전 확인사항:
- DeepSeek API 키 신청 완료
- 해당 SDK 설치 완료 (Python의 경우 pip install openai, Node.js의 경우 npm install openai)
스트림 출력:
- 기본값은 비스트림 출력
- stream=true 설정으로 스트림 출력 활성화 가능
- 스트림 출력은 실시간 응답이 필요한 상황에 적합
모델 설명:
- deepseek-chat 모델은 DeepSeek-V3로 전면 업그레이드
- 인터페이스는 변경 없이 유지, 기존 코드 수정 불필요
- model='deepseek-chat' 지정으로 최신 버전 사용 가능

다음 단계

기본 설정을 완료한 후 할 수 있는 작업:

고급 API 매개변수 탐색
스트림 출력 기능 구현
애플리케이션에 통합
API 호출 효율성 최적화

이제 DeepSeek API를 사용하여 AI 애플리케이션을 구축하실 수 있습니다!