API 연동 방법

[烏鷺路로]

API 연동 방법
 
DeepSeek의 API는 OpenAI와 거의 동일한 형식으로 구성되어 있어, 기존 GPT 프로젝트를 쉽게 전환하거나 통합할 수 있습니다. 아래에 단계별로 API 연동 방법을 정리해 보겠습니다.
 
 1단계: 계정 생성 및 API 키 발급
  - DeepSeek 공식 플랫폼에 접속해 계정을 생성합니다.
  - 로그인 후 API Keys 섹션에서 새 키를 생성하고 안전한 장소에 저장하세요.
  - 키는 한 번만 표시되므로 꼭 복사해두어야 합니다2.

 2단계: API 설정
DeepSeek API는 OpenAI SDK와 호환되므로, 아래와 같은 방식으로 설정할 수 있어요:

python
from openai import OpenAI

client = OpenAI(
    api_key = "your_deepseek_api_key",
    base_url = "https://api.deepseek.com"
)

response = client.chat.completions.create(
    model = "deepseek-chat",  # 또는 "deepseek-reasoner"
    messages = [
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "안녕하세요, DeepSeek!"}
    ],
    stream = False  # 실시간 응답을 원하면 True
)

print(response.choices[0].message)

3단계: 테스트 및 디버깅
  - Apidog 같은 API 테스트 툴을 사용하면 cURL 명령을 붙여넣고 바로 테스트 가능.
  - 환경 변수에 API_KEY를 설정하고, Authorization: Bearer {{API_KEY}} 형식으로 요청을 보냅니다.
  - 실시간 스트리밍 응답도 지원되며, stream=True로 설정하면 됩니다.

■ 팁과 주의사항

항목	설명
모델 선택	deepseek-chat (V3), deepseek-reasoner (R1)
비용 관리	캐시 히트율을 높이면 토큰 비용 절감 가능
보안	API 키는 절대 공개 저장소에 올리지 마세요
호환성	OpenAI SDK 그대로 사용 가능, 코드 수정 최소화

DeepSeek API는 저비용·고성능·오픈소스라는 강점을 살려 다양한 프로젝트에 쉽게 통합할 수 있습니다.