DeepSeek, 자체 검색 API 개방 — Search·Fetch와 Flash 1017 변화

SVIL - Singularity Visual Intelligence Lab 2026. 10. 18 9 min read

검색과 모델 업데이트, 한날의 두 변화

DeepSeek는 10월 17일 변경 기록에 자체 Search·Fetch API 개방과 V4.1 Flash 1017 갱신을 함께 올렸습니다. 검색 기능을 외부 개발 흐름으로 열고, 기본 Flash 모델도 업데이트한 두 변화입니다.

24시간 뉴스로 다루는 이유

변경 기록은 10월 17일 날짜만 표시하고 정확한 시각은 공개하지 않습니다. 예약 기준 시각 안의 당일 항목으로 다루되, 분 단위 발표 시각을 확인한 것처럼 적지는 않습니다.

Search는 웹 문서를 찾습니다

Search API는 질의에 맞는 웹페이지를 구조화된 결과로 돌려줍니다. DeepSeek는 자사 검색엔진이 다국어 웹을 색인하고 결과를 실시간으로 제공한다고 설명하지만, 이는 사업자의 설명입니다.

Fetch는 지정한 페이지를 읽습니다

Fetch API는 URL 하나를 받아 제목과 추출된 본문을 Markdown으로 반환합니다. Search가 후보를 찾는 단계라면 Fetch는 모델이나 응용 프로그램이 선택한 한 페이지의 내용을 확인하는 단계입니다.

두 개의 호출 주소

공식 가이드에 나온 주소는 `/v1/tools/search`와 `/v1/tools/fetch`입니다. 둘 다 `https://api.deepseek.com`을 기준으로 하며, OpenAI 호환 채팅 요청 안에 숨겨진 기능이 아니라 별도의 JSON API 호출입니다.

인증은 기존 API 키로

요청에는 `Authorization: Bearer` 형식의 DeepSeek API 키와 JSON 콘텐츠 유형을 보냅니다. 키를 브라우저 코드에 넣지 말고 서버 측 비밀 저장소에 두는 것이 기본 보안 경계입니다.

Search 요청의 핵심 필드

필수 값은 1~128자 질의입니다. 결과 수는 기본 10개이며 1~50 범위에서 조정할 수 있고, `need_content`를 켜면 본문 추출 내용이 가능한 경우 응답에 포함됩니다.

검색 결과의 정보

응답은 제목·URL·요약·짧은 발췌·사이트 이름·날짜·권위 등급과 재순위 점수를 제공하도록 문서화돼 있습니다. 사이트 날짜가 없거나 본문이 비는 경우도 있으므로 필드의 결측을 정상적인 데이터 상태로 다뤄야 합니다.

Fetch 응답은 Markdown 본문

Fetch는 페이지 제목과 Markdown 형식 본문을 돌려줍니다. 대상 사이트의 접근 정책이나 제공 방식에 따라 실패할 수 있어, 호출 성공을 웹의 모든 문장을 완전하게 읽었다는 뜻으로 확대하면 안 됩니다.

검색 연산자와 언어 필터

`site:`, `after:`, `before:`, 정확 문구와 언어 지정 같은 검색 문법을 지원합니다. 여러 조건을 질의에 담으면 후보 범위를 줄이는 데 유용하지만, 검색식이 복잡해질수록 누락 가능성도 함께 점검해야 합니다.

‘실시간’은 원문 확인을 대신하지 않습니다

결과의 날짜와 권위 점수는 검색 시스템의 신호이지 사실 판정의 보증서가 아닙니다. 중요한 정책·가격·제품 기능은 검색 결과를 원문 사이트에서 다시 확인하고, 발표문과 보도 분석을 구분해야 합니다.

검색 품질에 대한 사업자 주장

DeepSeek는 스팸과 저품질 생성문을 걸러 권위 있고 시의성 있는 결과를 제공한다고 소개합니다. 외부 공개 자료에는 독립적인 정확도 비교가 붙어 있지 않으므로 성능 수치는 제품 소개의 주장으로 읽어야 합니다.

성공 요청 기준 과금

공식 가이드는 Search와 Fetch 각각 성공 요청 1,000회당 0.75달러라고 적습니다. Search는 HTTP 200에 비어 있지 않은 결과가, Fetch는 HTTP 200에 본문이 있어야 과금되는 기준으로 설명합니다.

초기 무료 적용 범위

출시 뒤 첫 2주 동안 Codex와 Claude Code 내장 웹 검색은 Search API 요청료를 청구하지 않는다고 문서화돼 있습니다. 이 문구를 개발자가 직접 호출하는 모든 Search·Fetch API의 무상 사용으로 넓혀 읽으면 안 됩니다.

요청 속도 제한

계정별 Search와 Fetch는 서로 별도로 초당 5회 제한이 있습니다. Fetch에는 대상 도메인별 제한도 추가되며, 초과 요청은 429로 돌아올 수 있어 병렬 수집에는 백오프와 캐시가 필요합니다.

에이전트에서의 호출 흐름

에이전트는 질문을 짧은 검색 질의로 바꾸고 Search 결과 중 신뢰할 후보를 고른 뒤 Fetch를 호출할 수 있습니다. 최종 답변에는 URL과 날짜를 보존해 사람이 원문을 다시 열 수 있게 해야 합니다.

문서의 실제 호출 예제

공식 안내는 ‘DeepSeek V4 release’를 검색하고 결과의 URL과 요약을 읽은 뒤 특정 문서를 Fetch하는 Python 예제를 보여 줍니다. 이를 그대로 실행하기보다 오류 처리, 키 보관, 빈 결과 처리를 추가해야 실제 서비스에 가깝습니다.

RAG 파이프라인의 달라지는 부분

웹 자료를 지식 원천에 넣는 팀은 별도 검색 공급자와 본문 추출기를 각각 연결하던 작업을 단순화할 수 있습니다. 다만 색인된 자료의 범위, 추출 품질, 보존 정책은 각 팀이 실제 질의로 검증해야 합니다.

실패 응답을 구분하기

문서에는 잘못된 요청 400, 인증 401, 보안 정책 차단 403, 가져올 수 없는 페이지 404, 속도 제한 429 등이 나옵니다. 408·429·5xx만 기다린 뒤 재시도 권고가 있으며, 나머지 4xx는 요청을 고치지 않고 반복하지 말라고 안내합니다.

V4.1 Flash 1017 갱신

같은 변경 기록은 V4.1 Flash를 1017 버전으로 올렸다고 알립니다. DeepSeek는 공식 웹·앱 모델에도 적용했고, 기존 호출 이름 `deepseek-flash`와 API 가격·호출 방식은 유지된다고 밝혔습니다.

벤치마크 표는 자체 발표입니다

DeepSeek가 공개한 시험에는 추론·코딩·에이전트·시각 과제가 포함됩니다. 서로 다른 시험의 점수를 하나의 종합 순위처럼 합치기보다, 각 시험의 조건과 비교 버전이 같은지 확인해야 업데이트의 의미가 분명해집니다.

짧은 출력과 빠른 실행 주장

회사는 새 버전이 작업 시간을 줄이고 출력 길이를 낮췄다고 설명합니다. 실제 비용과 체감 속도는 질의 길이, 캐시 적중, 도구 호출 횟수와 응답 품질에 달려 있으므로 자신의 작업 묶음으로 재측정해야 합니다.

도입 전에 확인할 시험

개발팀은 Search와 Fetch의 빈 결과, 차단된 도메인, 오래된 날짜, 다국어 질의, 429 재시도, 출처 일치 여부를 작은 테스트 모음으로 점검할 수 있습니다. 평가 기록에는 모델 버전과 수집 시각도 함께 남기는 편이 좋습니다.

핵심 정리

이번 변화는 검색 인프라를 API로 열고 Flash 모델도 같은 날 갱신했다는 점입니다. Search·Fetch는 실제 원문 접근을 돕지만 근거 판정까지 자동으로 보증하지 않으며, 과금·속도 제한·원문 검증을 함께 설계해야 합니다.

출처

협업문의 : kuroicode@gmail.com
블로그 : https://blog.svil.dev/
홈페이지 : https://svil.dev/