DeepSeek V4.1 Flash 마이그레이션 가이드: V4 Pro·Flash·Vision 전환 체크리스트
deepseek-v4-flash와 deepseek-v4-pro는 영향을 받지 않으며 계속 DeepSeek V4 Flash와 V4 Pro를 제공합니다. 바뀐 것은 deepseek-v4-flash-vision-exp뿐으로, 이제 DeepSeek V4.1 Flash로 리디렉션됩니다. 따라서 공급자의 마감일에 쫓겨 이전하는 대신, 기존 Flash·Pro 워크로드를 그대로 운영하면서 V4.1 Flash를 나란히 평가할 수 있습니다.모델 ID별로 무엇이 바뀌었나
| 모델 ID | DeepSeek 직결 API | EvoLink | 해야 할 일 |
|---|---|---|---|
deepseek-v4-flash | 9월 10일부터 V4.1 Flash로 라우팅 | 영향 없음, 계속 DeepSeek V4 Flash | 그대로 운영하고, 이미지 입력이나 새 모델이 필요할 때 V4.1 Flash를 평가 |
deepseek-v4-flash-vision-exp | 9월 10일부터 V4.1 Flash로 라우팅 | DeepSeek V4.1 Flash로 리디렉션 | 이미지 평가 세트를 다시 실행하고 ID를 deepseek-v4.1-flash로 변경 |
deepseek-v4-pro | 9월 14일 UTC 04:00부터 V4.1 Flash로 라우팅 | 영향 없음, 계속 DeepSeek V4 Pro | 직결 API 사용자는 전환 시점 전에 준비. EvoLink 사용자는 강제 변경 없음 |
deepseek-flash | 현재 V4.1 Flash의 공식 이름 | EvoLink 모델 ID가 아님 | DeepSeek 직결 API에서만 사용 |
deepseek-v4.1-flash | DeepSeek 직결 API 이름이 아님 | DeepSeek V4.1 Flash | 새 EvoLink 연동에 사용 |
/deepseek-v4-1-flash는 하이픈을 쓰며 모델 ID가 아닙니다. 응답이 요청한 모델 이름을 그대로 돌려주는 것은 로그에 유용하지만, 각 결과를 어느 공급자의 어느 ID가 만들었는지는 별도로 기록해 두세요.어떤 애플리케이션부터 조치해야 하나?
요청이 실제로 가는 곳과, 답이 달라졌을 때 생기는 영향의 크기로 우선순위를 정하세요.
| 애플리케이션 | 상황 | 첫 조치 |
|---|---|---|
DeepSeek 직결 API에서 deepseek-v4-pro 호출 | 9월 14일부터 V4.1 Flash가 처리 | 전환 시점 전에 기준 출력과 테스트를 저장하고, V4.1 Flash가 기준을 통과하는지 아니면 EvoLink 같은 다른 경로로 V4 Pro를 계속 써야 하는지 결정 |
DeepSeek 직결 API에서 deepseek-v4-flash 또는 deepseek-v4-flash-vision-exp 호출 | 이미 V4.1 Flash가 처리 | 최근 결과를 9월 10일 이전에 저장한 출력과 비교 |
EvoLink에서 deepseek-v4-flash-vision-exp 사용 | 이미 V4.1 Flash로 리디렉션 | 시각 평가 세트를 다시 실행하고 ID를 deepseek-v4.1-flash로 변경 |
EvoLink에서 deepseek-v4-flash 또는 deepseek-v4-pro 사용 | 변경 없음 | 강제 마이그레이션 없음. 실제 작업 표본으로 V4.1 Flash를 평가 |
| DeepSeek 직결 API에서 Flash와 Pro를 서로의 폴백으로 사용 | 9월 14일 이후 두 이름 모두 V4.1 Flash로 연결 | 서로 다른 모델을 계속 제공하는 경로(예: EvoLink의 V4 Flash와 V4 Pro)로 교체하고, 두 경로가 공급자·쿼터·장애 지점을 공유하지 않는지 별도로 확인 |
필수 프로토콜, 과금 규칙, 롤백 대상 중 하나라도 불명확하다면 운영 트래픽을 늘리지 마세요. 그동안에도 테스트 케이스를 준비하고, 후보 경로를 구성하고, 중요도가 낮은 작업을 평가할 수는 있습니다. 짧은 텍스트 요청 하나가 성공한 것은 검증의 시작일 뿐 끝이 아닙니다.
첫 변경은 작게, 그다음 클라이언트 동작을 검증
첫 비교에서는 기존 프롬프트, 도구 Schema, 작업 테스트 케이스를 그대로 두세요. 모델, 클라이언트 라이브러리, 프롬프트, 추론 설정을 한꺼번에 바꾸면 회귀의 원인을 찾기 어렵습니다.
deepseek-v4.1-flash로 설정하고, 모델 페이지의 요청 예시에서 시작하세요. DeepSeek Chat 문서에 EvoLink의 DeepSeek 공통 요청 형식이 설명되어 있습니다. 직결 API 예시를 그대로 옮기지 말고 엔드포인트, 인증, 지원 필드를 먼저 확인하세요.다음 클라이언트 동작은 따로따로 점검하세요.
- 사고(thinking) 제어: DeepSeek 문서에 따르면 직결 API에서는 사고 모드가 기본으로 켜져 있습니다. "선택 가능"을 "꺼져 있음"으로 해석하지 말고 요청이 실제로 쓰는 설정을 확인한 뒤, 평가를 실행할 때마다 기록하세요. 사고 모드 가이드
- 대화 기록: 어떤 메시지, 추론 블록, 도구 결과를 다시 보내야 하는지 확인하세요. 첫 턴이 성공했다고 다단계 대화가 동작한다는 뜻은 아닙니다.
- 도구 실행: 도구 이름, 인자 파싱, 호출 ID, 결과 순서, 다음 어시스턴트 턴을 확인하세요. 외부에 부작용이 있는 작업을 연결하기 전에 무해한 테스트 도구로 먼저 검증하세요.
- 스트리밍: 클라이언트가 완료 이벤트와 중단 이벤트를 올바르게 처리하는지 확인하세요. 첫 출력까지의 시간과 쓸 수 있는 완전한 답을 받기까지의 시간을 따로 기록하세요.
- 이미지 입력: 이미지 필드는 프로토콜마다 다릅니다(Chat Completions는
image_url, Messages는image블록, Responses는input_image). 여러 장을 보내기 전에 사용하는 프로토콜에서 이미지 한 장부터 테스트하세요. - 사용량: 실제 응답 필드와 계정 청구 금액을 확인하세요. 캐시 토큰 데이터가 없다면 사용량을 알 수 없다는 뜻이지, 캐시 적중이 0이라는 뜻이 아닙니다.
지금 쓰는 모델과 비교하기
deepseek-v4-flash 또는 deepseek-v4-pro)와 deepseek-v4.1-flash에 각각 보내고 결과를 나란히 비교하세요.Vision Exp는 예외입니다. 이 ID는 이미 V4.1 Flash로 리디렉션되므로 원래 모델과는 더 이상 비교할 수 없습니다. 리디렉션 전에 저장해 둔 출력을 사용하세요. DeepSeek 직결 API의 기존 이름도 마찬가지입니다. 같은 모델로 연결되는 두 이름에 같은 프롬프트를 보내는 것은 모델 비교가 아닙니다.
관리 가능한 규모의 대표 작업부터 시작하세요. 예를 들어 일상 작업, 어려운 사례, 긴 컨텍스트 입력, 이미 알려진 실패 사례에서 30–50개의 테스트 케이스를 고를 수 있습니다. 이는 출발점으로 제안하는 표본 크기일 뿐 통계적 보장이 아닙니다. 중요한 워크로드마다 충분한 사례를 넣어, 잘 나온 데모 하나가 다른 곳의 실패를 가리지 않게 하세요.
| 워크로드 | 현재 연동에서 보존할 것 | 후보 모델에서 측정할 것 |
|---|---|---|
| 코딩 | 입력 파일, 요청한 변경, 채택된 패치와 테스트 스위트 | 테스트 통과율, 의도하지 않은 수정, 미완료 작업, 리뷰 부담 |
| 에이전트 도구 | 도구 Schema, 기대 호출 순서, 최종 상태 | 인자 정확도, 중복 호출, 복구, 작업 완료 여부 |
| 구조화 추출 | 입력, 기대 필드, 검증 규칙 | Schema 유효성, 누락 값, 잘못된 값, 검토 비율 |
| 비전 | 원본 이미지와 라벨링된 가시적 근거 | 필드 정확도, 지어낸 세부 정보, 읽을 수 없는 내용의 처리 |
| 긴 컨텍스트 분석 | 필요한 원문 구절과 참조 답안 | 근거 재현율, 근거 없는 주장, 지연 시간, 작업 비용 |
각 결과 옆에 요청 구성을 함께 저장하세요. 모델 ID, 검증 날짜, 출력 한도, 추론 제어, 프롬프트 버전, 도구 정의, 컨텍스트 크기가 필요합니다. 결정에 영향을 줄 만큼 출력이 흔들리는 사례는 반복 실행하세요. 한 번의 실행을 보편적인 순위로 포장하지 말고 불확실성을 함께 보고하세요.
평가를 돌리기 전에 실패의 정의부터 정하세요. 유효하지 않은 패치, 엉뚱한 레코드에 적용되는 도구 인자, 지어낸 필수 필드는 답이 아무리 매끄럽게 읽혀도 실패로 처리해야 합니다. 덜 중요한 문체 차이는 별도 검토 항목으로 분리해 기능 회귀를 가리지 않게 하세요.
마이그레이션 수용 기록
공유 시트에 테스트 케이스마다 한 행씩 기록하세요. 각 결과를 실행 조건, 발생한 비용, 뒷받침하는 결정과 연결해 두면 같은 근거로 전환을 승인하거나 보류할 수 있습니다.
| 필드 그룹 | 기록할 내용 |
|---|---|
| 식별 정보와 조건 | 공급자와 base URL, 현재·후보 모델 ID, 프로토콜, 사고 설정과 강도, 프롬프트 버전, 테스트 세트 버전 |
| 작업과 결과 | 케이스 ID, 입력 유형(텍스트 또는 이미지), 기대 결과, 실제 출력, 통과·실패와 사유, 도구 부작용이나 중복 호출 |
| 실행과 비용 | 첫 출력까지의 시간, 완전한 결과까지의 시간, 입력·캐시·출력 사용량, 최종 청구 금액, 재시도 횟수 |
| 출시 결정 | 자체 통과 기준(예: 치명적 실패 0건), 관찰 기간, 트래픽 확대 조건, 중단 조건, 입력 유형에 맞는 폴백 대상 |
기록 예시(설명용이며 실제 측정 결과가 아님):
| 필드 | 예시 |
|---|---|
| 케이스 ID | INV-017 |
| 입력 유형 | 이미지: 스캔한 청구서 |
| 현재 → 후보 | deepseek-v4-flash-vision-exp에서 리디렉션 전에 저장한 출력 → deepseek-v4.1-flash |
| 기대 결과 | 청구서 번호, 날짜, 합계를 담은 JSON |
| 통과 규칙 | 세 필드 모두 라벨과 일치하고 지어낸 필드가 없음 |
| 결과 | 실패: 합계를 소계 줄에서 읽음 |
| 사용량과 청구 | 이 요청의 usage 필드와 최종 청구 금액을 기록 |
| 결정 | 청구서 트래픽은 후보 모델로 옮기지 않음. 비슷한 청구서를 테스트 세트에 추가한 뒤 재실행 |
| 폴백 대상 | 같은 청구서 세트를 통과한 다른 비전 모델, 또는 사람 검토 |
수용 검사를 통과한 뒤에만 트래픽 이동
기능 플래그나 라우팅 설정으로 범위가 정해진 워크로드에만 후보 모델을 선택하고, 어떤 요청이 후보 모델을 썼는지 기록하세요. 내부 작업이나 중요도가 낮은 작업부터 시작하고, 애플리케이션 검사를 통과한 뒤에 고객 트래픽을 넣으세요.
실용적인 순서는 다음과 같습니다.
- 요청을 확인합니다. 정확한 모델 ID, 프로토콜, 권한, 가격 출처를 점검하세요.
- 오프라인에서 테스트 케이스를 재생합니다. 현재 모델이나 저장해 둔 수용 기준과 비교해, 트래픽에 영향이 없는 상태에서 실패 원인을 진단하세요.
- 제한된 코호트로 운영합니다. 오류가 나도 영향을 가둘 수 있는 작은 워크로드나 테넌트 그룹을 고르고, 합격 결과·지연 시간·청구 금액을 모니터링하세요.
- 작업 유형별로 확대합니다. 통과한 작업에서 사용을 늘리고, 더 어렵거나 측정이 부족한 작업은 이미 통과한 모델에 남겨 두세요.
- 공급자 변경 후 다시 확인합니다. ID가 그대로라고 해서 앞으로의 회귀 테스트를 건너뛸 수 있는 것은 아닙니다.
기준값은 자신의 서비스 요구 사항에 맞춰 정하세요. 예를 들어 치명적인 도구 실패 0건, 기존 하한 이상의 Schema 유효율, 응답 예산 이내의 p95 지연 시간을 요구할 수 있습니다. 이는 애플리케이션 관문일 뿐 V4.1 Flash의 성능에 대한 주장이 아닙니다.
롤백 대상은 이전 동작을 여전히 제공하는 목적지여야 하고, 입력 유형과도 맞아야 합니다.
- 텍스트 전용 작업: EvoLink에서는
deepseek-v4-flash와deepseek-v4-pro를 계속 사용할 수 있으므로, V4.1 Flash에서 기준을 통과하지 못한 텍스트 코호트는 설정 변경으로 되돌릴 수 있습니다. - 이미지 근거에 의존하는 작업: V4 Flash와 V4 Pro는 텍스트 전용이라 이 작업을 넘겨받을 수 없습니다. 같은 시각 평가를 통과한 다른 모델로 폴백하거나, 처리를 멈추고 사람 검토로 보내세요. OCR과 텍스트 모델을 결합한 파이프라인은 레이아웃과 픽셀 정보가 사라져도 결과가 달라지지 않음을 확인한 경우에만 폴백이 될 수 있습니다. 이미지를 조용히 버리거나 자리표시자로 바꾼 뒤 그 응답을 성공으로 집계하지 마세요.
- Vision Exp:
deepseek-v4-flash-vision-exp는 이미 V4.1 Flash로 리디렉션되므로 롤백 대상이 아닙니다.
합격 결과당 비용으로 비교
평가 코호트에는 다음 식을 사용하세요.
합격 작업당 API 비용 = 실제 청구된 API 총비용 / 합격 작업 수실패한 시도와 재시도도 청구 총액에 포함하세요. 합격한 작업이 하나도 없으면 이 비율은 정의되지 않으므로 "성공당 비용 0"으로 보고하지 마세요. 사람 검토와 도구 서비스 비용은 따로 집계하고, 총운영비를 기준으로 판단한다면 그때 합산하세요.
가상의 비교로 차이를 보겠습니다. 총 1.00이 든 100개 작업 중 80개가 합격했다면 합격 작업당 비용은 0.0125입니다. 총 0.90이 들었지만 60개만 합격한 다른 구성은 합격 작업당 0.015입니다. 코호트 청구액이 더 낮은 쪽이 쓸 수 있는 결과 기준으로는 더 비쌉니다. 이 숫자는 설명용이며 EvoLink 가격이나 테스트 측정값이 아닙니다.
여러 변수를 한꺼번에 바꾸지 않고 실패 진단하기
| 증상 | 먼저 확인할 것 | 유용한 다음 단계 |
|---|---|---|
| 생성 전에 요청이 거부됨 | 활성 키, 엔드포인트, 모델 ID | 문서화된 최소 요청으로 확인하고 인증 문제와 모델 가용성 문제를 구분 |
| 텍스트는 성공하지만 이미지는 실패 | 이미지 필드와 선택한 프로토콜 | 여러 장이나 도구를 붙이기 전에 지원되는 이미지 한 장으로 테스트 |
| 첫 턴은 성공하지만 에이전트가 멈춤 | 도구 결과 ID, 대화 기록, 클라이언트 파서 | 결정론적인 테스트 도구로 두 단계 작업을 재현 |
| 출력이 잘림 | 출력 한도와 종료 사유 | 상한을 둔 범위에서 한도를 조정하고 무한 재시도 루프는 피함 |
| 단가가 비슷한데 청구액이 달라짐 | 추론, 캐시, 출력 길이, 실패한 시도 | 같은 합격 워크로드 기준으로 최종 청구 비용을 비교 |
| "롤백"했는데 동작이 그대로임 | 해당 ID가 새 모델로 리디렉션되는지 | 텍스트 작업은 EvoLink의 deepseek-v4-flash처럼 이전 모델을 계속 제공하는 ID로 되돌리고, 이미지 작업은 검증된 다른 비전 모델을 사용 |
문제 해결을 위해 민감 정보를 가린 요청, 응답, 시각, 요청 식별자를 보관하세요. 공개 버그 리포트에는 API 키나 고객의 민감한 입력을 넣지 마세요. 정확한 오류 이름과 HTTP 동작은 모델 ID 표기로 추측하지 말고 실제 응답과 현재 문서를 기준으로 판단하세요.
FAQ
EvoLink에서 기존 DeepSeek 요청의 모델 이름을 바꿔야 하나요?
deepseek-v4-flash와 deepseek-v4-pro는 바꿀 필요가 없습니다. 두 ID는 계속 V4 Flash와 V4 Pro를 제공합니다. deepseek-v4-flash-vision-exp는 여전히 작동하지만 이제 V4.1 Flash로 리디렉션되므로, 준비가 되면 deepseek-v4.1-flash로 바꾸고 이미지 검사를 다시 실행하세요.EvoLink에서 V4.1 Flash를 설정할 때 어떤 이름을 넣어야 하나요?
deepseek-v4.1-flash입니다. 웹사이트 경로는 하이픈을 쓰고, DeepSeek 직결 API는 deepseek-flash를 씁니다. 엔드포인트, 공급자, 식별자는 한 세트로 관리하세요. 서로 바꿔 쓸 수 없습니다.V4 Pro 전환은 언제이며 EvoLink에도 영향이 있나요?
deepseek-v4-pro에는 영향이 없으며 계속 V4 Pro를 제공합니다. DeepSeek API를 직접 호출한다면 전환 시점 전에 공지를 다시 확인하세요.기존 모델과 새 모델을 나란히 비교할 수 있나요?
deepseek-v4-flash 또는 deepseek-v4-pro와 deepseek-v4.1-flash에 보내세요. Vision Exp는 ID가 이미 V4.1 Flash로 리디렉션되므로 이전에 저장해 둔 출력과 비교해야 합니다. DeepSeek 직결 API의 기존 이름도 마찬가지입니다.사고 모드가 "선택 가능"하다는 것은 꺼져 있다는 뜻인가요?
아닙니다. 지원되는 곳에서 비사고 모드도 쓸 수 있다는 뜻입니다. 요청이 실제로 쓰는 설정을 확인하고 평가 결과와 함께 기록하세요.
마이그레이션하면 청구 금액이 줄어드나요?
계정 요율, 토큰 구성, 추론량, 캐시 재사용, 재시도, 합격률에 따라 달라집니다. 동등한 작업의 최종 청구 금액으로 측정하세요. 직결 공급자의 가격 인하나 공시 요율을 청구서에 대한 보장으로 여기지 마세요.
EvoLink에서 Vision Exp 이미지 워크로드는 어떻게 되나요?
deepseek-v4.1-flash로 바꾸세요.마이그레이션 후 유용한 폴백은 무엇인가요?
deepseek-v4-flash와 deepseek-v4-pro가 계속 V4 Flash와 V4 Pro를 제공합니다. 이미지 작업에서는 이 두 모델이 텍스트 전용이므로 검증된 다른 비전 모델이나 사람 검토 경로를 사용하세요. deepseek-v4-flash-vision-exp처럼 V4.1 Flash로 리디렉션되는 ID로 바꾸는 것은 이전 동작으로의 롤백이 아닙니다.출처와 다음 단계
공급자 문서는 2026년 9월 10일에 확인했습니다.
