한 줄 정의
Reasoner는 DeepSeek API에서 생각 모드 답변을 요청할 때 쓰는 모델 이름이야. 문서나 로그에서 deepseek reasoner처럼 공백으로 적힌 표현도 보통 같은 API 별칭을 가리켜. 처음에는 DeepSeek R1을 호출하는 이름으로 나왔지만, 시간이 지나며 실제 뒤에 붙는 모델이 바뀐 legacy 별칭에 가까워졌어.
그래서 이 용어를 보면 “어떤 DeepSeek 모델인가”보다 먼저 “어느 날짜의 API 문서인가”를 봐야 해. 2025년 1월에는 R1, 2025년 12월에는 DeepSeek V3.2 thinking mode, 2026년 5월 3일 현재는 DeepSeek V4 Flash의 thinking mode로 읽어야 해.
이 모델로 무엇을 할 수 있나
실제로는 OpenAI 호환 Chat Completions 코드에서 이 모델 값을 넣어 수학 풀이, 코드 분석, 긴 계획 수립처럼 중간 추론이 필요한 요청을 처리할 때 쓰였어. 응답에는 최종 답변인 content와 생각 모드 내용인 reasoning_content가 나뉘어 들어와서, 일반 채팅 모델을 붙일 때보다 로그와 후속 요청 처리가 더 까다로워.
예를 들어 사내 검색 에이전트가 먼저 문제를 해석하고, 검색 도구를 부르고, 그 결과를 다시 읽어 답을 만드는 흐름이라면 thinking mode가 도움이 될 수 있어. 다만 도구 호출이 끼는 요청에서는 reasoning_content를 다음 API 호출에도 이어서 보내야 해서, 단순히 모델명만 갈아 끼우면 400 오류나 맥락 누락이 생길 수 있어.
새 코드라면 legacy 이름을 계속 쓰기보다 deepseek-v4-flash나 deepseek-v4-pro를 직접 고르고 thinking 설정을 명시하는 편이 나아. DeepSeek가 deepseek-chat과 deepseek-reasoner를 2026년 7월 24일 15:59 UTC 이후 종료한다고 공지했기 때문이야.
왜 중요한가
이 이름이 중요한 이유는 같은 문자열이 서로 다른 모델 세대를 가리키기 때문이야. 2025년 초 기사에서 Reasoner가 나오면 R1 API 출시와 MIT 라이선스 오픈 웨이트 전략을 말하는 경우가 많아. 그런데 2025년 12월 이후 문서라면 V3.2 thinking mode 얘기일 수 있고, 2026년 4월 24일 이후 운영 문서라면 V4-Flash compatibility routing 얘기일 수 있어.
이 차이를 놓치면 비교표가 틀어져. R1의 671B total / 37B active와 V4-Flash의 284B total / 13B active를 같은 모델 숫자처럼 붙이면 안 돼. 가격도 마찬가지야. R1 출시 가격과 2026년 5월 V4-Flash 가격표는 이름이 이어져 보일 뿐, 비용 판단 기준은 서로 달라.
도입 판단도 여기서 갈려. 공개 웨이트를 내려받아 직접 돌릴 생각이면 R1, V3.2, V4의 실제 저장소와 라이선스를 확인해야 해. API를 쓰는 팀이라면 모델명 폐기 일정, thinking mode 파라미터, reasoning_content 저장 방식, 도구 사용 흐름을 먼저 점검해야 해.
주의해서 볼 점
- 2025-01-20: DeepSeek는 R1 API 사용법으로 Reasoner 모델 값을 안내했고, R1 저장소는 671B total / 37B active / 128K 공개 모델과 6개 distill 모델을 설명했어.
- 2025-05-28: 변경 로그는 Reasoner가 DeepSeek-R1-0528로 올라갔다고 적고, AIME 2025와 GPQA 같은 reasoning 지표 개선을 제시했어.
- 2025-12-01: DeepSeek는 Chat 계열과 Reasoner 계열을 V3.2로 올렸고, 두 이름을 non-thinking mode와 thinking mode로 나눴어.
- 2026-04-24: V4 Preview 이후 두 legacy 이름은 V4-Flash의 non-thinking/thinking mode로 라우팅돼.
- 2026-07-24 15:59 UTC: DeepSeek 공지 기준 legacy 이름이 완전히 종료되는 시각이야. 이 날짜 뒤에도 돌아가야 하는 제품이면 모델명을 새 값으로 바꿔야 해.
같이 보면 좋은 모델
- DeepSeek R1: Reasoner가 처음 연결된 공개 reasoning 모델이야. API 별칭과 오픈 웨이트 모델을 구분할 때 먼저 봐.
- DeepSeek V4: 2026년 4월 이후 이 legacy 이름이 실제로 어디로 라우팅되는지, 또 어떤 새 모델명으로 옮겨야 하는지 확인할 때 필요해.
- DeepSeek V3.2: 2025년 12월부터 thinking mode와 tool-use 흐름이 어떻게 묶였는지 볼 때 비교 기준이 돼.
- o3: reasoning API 제품끼리 비교할 때 함께 놓을 수 있어. 다만 o3는 OpenAI 제품명이고, Reasoner는 DeepSeek의 변경 가능한 API 별칭이라는 차이가 커.