DeepSeek V4 API 사용자 가이드

1. 등록 및 인증

DeepSeek V4 API는 OpenAI SDK와 호환되므로 마이그레이션 비용을 크게 줄이고 개발자가 기존 AI 생태계 도구와 원활하게 통합할 수 있습니다.

API 키 얻기

1. DeepSeek 플랫폼을 방문하십시오.
2. 오른쪽 상단 모서리에 있는 "API Keys" -> "Create new secret key"를 클릭하십시오.
3. 참고: 키는 생성 시 한 번만 표시되므로 안전하게 저장하십시오.

2. 빠른 시작 (Python 예제)

먼저 공식 OpenAI SDK를 설치합니다 (예, 맞습니다. 그냥 OpenAI SDK를 사용하면 됩니다):

pip install openai

그런 다음 base_url과 api_key 두 가지 매개변수만 수정하면 됩니다.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # 귀하의 DeepSeek API 키
    base_url="https://api.deepseek.com"  # 핵심 포인트!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # 모델 이름, V4 출시 후 다를 수 있음
    messages=[
        {"role": "system", "content": "You are a helpful AI assistant."},
        {"role": "user", "content": "Hello, please introduce DeepSeek V4."},
    ],
    stream=False
)

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

3. 고급 기능

3.1 스트리밍 출력

사용자 경험을 향상시키려면 사용자가 타자기와 같은 생성 효과를 볼 수 있도록 스트리밍 출력을 활성화하는 것이 좋습니다.

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Write a long poem about whales"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 함수 호출 (Function Calling)

DeepSeek V4는 강력한 함수 호출을 지원하여 JSON 매개변수를 정확하게 파싱할 수 있어 에이전트(Agents) 구축에 이상적입니다.

3.3 JSON 모드

모델이 유효한 JSON 형식을 출력해야 하는 경우 response_format에서 json_object를 지정하고 프롬프트에서 명시적으로 JSON 출력을 요청하십시오.

4. 가격 및 비용 최적화

DeepSeek V4 가격은 매우 저렴합니다 (공식 발표 대기 중인 특정 가격, V3는 $0.14/M 토큰 참조). 비용을 더 절약하려면:

• 프롬프트 캐싱: V4는 컨텍스트 캐싱 메커니즘을 도입합니다. 시스템 프롬프트가 긴 경우(예: 지식 베이스), 후속 요청은 캐시 적중으로 인해 비용이 훨씬 적게 듭니다.
• 컨텍스트 간소화: 관련 없는 채팅 기록을 채워 넣지 마십시오.

5. 모범 사례

• 오류 처리: 특히 rate_limit_exceeded (429) 오류에 대해 지수 백오프 재시도 전략으로 try-except를 구현해야 합니다.
• 시간 초과 설정: 복잡한 추론 작업은 더 긴 생성 시간이 필요할 수 있으므로 시간 초과를 60초 이상으로 설정하십시오.
• 시스템 프롬프트: V4에 명확한 "페르소나"를 부여하면 더 잘 수행됩니다.

문제가 있습니까? API 설명서를 확인하거나 Discord 커뮤니티에 가입하여 도움을 받으십시오.