2026년 8월 26일 기준 DeepSeek 공식 API의 현재 선택지는 deepseek-v4-flash, deepseek-v4-pro, 실험형 deepseek-v4-flash-vision-exp입니다. 새 프로젝트에서 R1과 V3 중 하나를 고르던 방식은 이제 현재 API 계약을 설명하지 못합니다.
실무 출발점은 간단합니다. 텍스트, 구조화 출력, 일반적인 코딩/에이전트 작업은 V4 Flash로 기준선을 만듭니다. 고난도 코드, 복잡한 추론, 긴 도구 체인에서 의미 있는 합격률 차이가 보일 때 V4 Pro를 비교합니다. 스크린샷이나 차트가 실제 입력일 때만 Vision Exp를 선택하고, 실험 모델용 fallback을 준비합니다.
DeepSeek 앱/웹의 모델, 공식 API ID, 오픈 웨이트, 제3자 게이트웨이의 같은 이름은 서로 다른 이용면입니다. 한쪽의 버전, 요금, 기능을 다른 쪽의 보장으로 옮길 수 없습니다.
최신 세 모델을 먼저 구분하기
DeepSeek 공식 API 시작 문서는 두 텍스트 ID가 현재 V4-Flash-0731과 V4-Pro-0813을 가리킨다고 설명합니다. Vision Exp는 8월 21일 API 플랫폼에 공개된 실험 모델입니다.
| API 모델 ID | 먼저 시험할 작업 | 중요한 한계 |
|---|---|---|
deepseek-v4-flash | 대화, 추출, 변환, JSON, 일상 코딩, 비용 중심 에이전트 | 복잡한 지식과 장기 에이전트에서는 Pro와 실제 차이를 확인해야 함 |
deepseek-v4-pro | 어려운 코드 변경, 오류 비용이 큰 판단, 다단계 도구 작업 | 같은 시간대·캐시 상태에서 토큰 요금이 Flash의 약 3배 |
deepseek-v4-flash-vision-exp | 화면 캡처, 도표, 스캔, 시각 상태를 쓰는 에이전트 | 실험 모델이므로 검증, 버전 모니터링, 대체 경로가 필요 |
공식 변경 로그에 따르면 V4 Pro는 8월 13일 앱, 웹, API에 정식 배포됐습니다. 반면 Vision Exp의 핵심 조건은 이름 그대로 실험성입니다. 모델 성능표보다 이 운영 상태를 먼저 아키텍처에 반영해야 합니다.
100만 토큰은 Pro만의 장점이 아니다
모델·요금 표는 세 모델 모두 1M context와 최대 384K 출력을 표시합니다. JSON Output, Tool Calls, Responses API, Anthropic 호환 API도 공통입니다. FIM은 두 텍스트 모델의 non-thinking 모드에서만 지원되고 Vision Exp는 지원하지 않습니다.
따라서 긴 입력이 필요하다는 이유만으로 Pro를 고를 수 없습니다. 실제 검증에서는 긴 문서에서 근거를 정확히 찾는지, 뒤쪽 지시를 유지하는지, 도구 상태를 잃지 않는지, 출력 길이를 통제하는지 측정해야 합니다.
오픈 웨이트는 별도 배포 결정입니다. DeepSeek 공식 V4 저장소는 Pro를 총 1.6T/활성 49B, Flash를 총 284B/활성 13B의 MoE 모델로 공개하며 MIT 라이선스를 명시합니다. 이것은 셀프 호스팅 가능성을 뜻하지만, 특정 양자화·GPU·서빙 프레임워크가 공식 API의 품질과 속도를 재현한다는 뜻은 아닙니다.
요금은 모델, 시간, 캐시, 출력으로 계산한다
DeepSeek의 평일 피크 시간은 01:00–04:00, 06:00–10:00 UTC입니다. 한국 시간으로는 10:00–13:00, 15:00–19:00 KST이며, 나머지 시간은 비피크 반값 요금입니다.
2026년 8월 26일 공식 USD/백만 토큰 요금은 다음과 같습니다.
| 모델 | 시간대 | 캐시 적중 입력 | 캐시 미적중 입력 | 출력 |
|---|---|---|---|---|
| Flash / Vision Exp | 비피크 | $0.007 | $0.22 | $0.66 |
| Flash / Vision Exp | 피크 | $0.014 | $0.44 | $1.32 |
| Pro | 비피크 | $0.022 | $0.66 | $1.98 |
| Pro | 피크 | $0.044 | $1.32 | $3.96 |
캐시 적중 최저가만으로 비용을 설명하면 실제 작업과 멀어집니다. 비피크에 캐시 미적중 입력 20만 토큰과 출력 2만 토큰을 사용하면 Flash는 약 $0.0572, Pro는 $0.1716입니다. 다만 Pro가 재시도와 사람의 수정 시간을 충분히 줄인다면 승인된 결과 한 건의 비용은 달라질 수 있습니다.
사고 모드는 모델과 별도의 스위치다
V4 Flash와 Pro는 thinking을 끌 수 있고, 켤 때 low, high, max 추론 강도를 지원합니다. DeepSeek 사고 모드 문서의 기본값은 thinking enabled와 high입니다. 호환 입력 medium, xhigh는 현재 high로 매핑됩니다.
비교할 때 먼저 Flash에서 acceptance를 만족하는 가장 낮은 effort를 찾고, 같은 effort로 Pro를 비교합니다. Flash-low와 Pro-max의 차이를 전부 모델 차이로 해석할 수는 없습니다.
thinking 모드에서는 temperature, top_p, presence_penalty, frequency_penalty가 무시됩니다. tools가 있는 멀티턴 요청은 도구를 호출하지 않은 턴도 reasoning_content를 다음 요청에 다시 전달해야 하며, 누락하면 400이 발생할 수 있습니다. 클라이언트가 이 계약을 지키는지 먼저 확인해야 합니다.
Vision Exp를 선택할 수 있는 조건
Vision API 가이드는 JPEG, PNG, GIF, WebP를 base64, 외부 URL, Files API로 받을 수 있다고 설명합니다. 일반 Flash와 Pro에 이미지를 보내면 400입니다.
Vision Exp는 UI 오류 스크린샷, 차트 해석, 스캔 문서 추출, 화면 상태를 읽는 에이전트에 적합한 후보입니다. 그러나 실험 모델이므로 중요한 시각 결론을 스키마나 규칙으로 검증하고, 평가 기록에 관찰 버전을 남기며, 이미지가 선택 사항이면 텍스트 경로로 돌아갈 수 있어야 합니다.
이미지는 입력 토큰으로 환산되며 현재 전처리 후 장당 최대 384토큰입니다. 파일 크기, 요청 본문, 이미지 수와 차원 제한은 별도로 적용되므로 작은 글자, 밀집 표, 여러 이미지 순서를 실제 자료로 시험해야 합니다.
R1·V3.2 자료를 읽는 방법
R1은 DeepSeek 추론 계보에서 중요하고 V3.2는 연구와 오픈 웨이트 배포에서 여전히 의미가 있습니다. 하지만 V4 API 공개 당시 DeepSeek는 deepseek-chat, deepseek-reasoner를 중단 경로에 두고 한시적으로 V4 Flash의 non-thinking/thinking에 연결했습니다.
새 코드는 현재 명시적 ID를 사용하는 편이 안전합니다. 이전할 때 model 문자열만 바꾸지 말고 provider, base URL, 실제 버전, 지원 필드, 대표 작업 결과를 기록해야 합니다. 서드파티가 유지한 이전 alias가 공식 API와 같은 스냅샷을 뜻하지는 않습니다.
14개 작업으로 라우팅을 끝내기
일반 작업 6개, 어려운 작업 4개, 도구 실패 2개, 장문 또는 이미지 경계 2개를 준비합니다. 같은 prompt, tools, effort, acceptance로 Flash와 Pro, 필요한 경우 Vision Exp를 실행합니다. 첫 합격률, 최종 합격률, 입력/추론/출력 토큰, 캐시, 지연시간, 재시도, 사람 수정, 승인 결과당 총비용을 기록합니다.
Flash가 모든 핵심 작업을 통과하면 Flash에서 멈춥니다. Pro가 일부 어려운 작업만 개선하면 그 범위만 Pro로 라우팅합니다. 이미지가 필수가 아니라면 실험 의존성을 추가하지 않습니다. Pro의 접속과 세부 trade-off는 DeepSeek V4 Pro API 가이드에서 이어서 확인할 수 있습니다.
좋은 선택은 가장 큰 모델을 고정하는 것이 아니라, 실제 합격 기준을 반복해서 만족하는 최소 비용 구성을 만들고 관찰 가능한 차이가 있을 때만 상위 모델과 실험 기능을 추가하는 것입니다.
