Lotook
DeepSeek는 2026년 11월 13일 Change Log에서 Messages, Responses, Chat Completions 엔드포인트를 통해 deepseek-flash의 웹 검색, 심층 사고 검색, URL 읽기, 파일 입력, 안전성 검사를 개발자에게 공개했습니다. 별도의 Search와 Fetch, OCR, 음성 인식, 음성 합성 API도 제공하며 토큰 요금에 더해 과금합니다.
DeepSeek는 2026년 11월 13일 무엇을 발표했나요?
DeepSeek는 2026년 11월 13일 공식 Change Log에 ’전체 애플리케이션 API 제품군 출시’라는 글을 게시하고 DeepSeek App과 웹 클라이언트의 기능을 개발자에게 제공했습니다. DeepSeek는 웹 검색, 파일 입력, URL 읽기, 음성 상호작용, 안전성 기능이 이미 앱에서 모델 추론과 함께 실행되고 있다며 “오늘 이 기능들을 개발자에게 공개합니다”라고 밝혔습니다. 도구 실행과 컨텍스트 구성은 서비스가 관리합니다. DeepSeek는 베이징 시간 11월 13일 공식 X 계정에서도 출시 소식을 전했습니다.
이번 출시는 deepseek-flash 채팅에 통합된 다섯 가지 기능과 네 가지 독립 유틸리티 API인 Search와 Fetch, OCR, 자동 음성 인식(ASR), 음성 합성(TTS)을 포함합니다. 이에 앞서 2026년 10월 17일 Change Log 업데이트에서 DeepSeek는 자체 검색 API인 DeepSeek Search와 deepseek-flash 모델명으로 제공되는 DeepSeek-V4.1-Flash-1017을 공개했습니다. DeepSeek에 따르면 이 검색 API는 수천억 개의 웹 페이지를 색인합니다.
DeepSeek는 엔드포인트를 시연하기 위해 내보낸 DeepSeek 채팅 기록을 가져올 수 있는 브라우저 기반 채팅 클라이언트를 오픈소스로 공개했습니다(라이브 데모와 GitHub 저장소). DeepSeek는 API 키, 대화, 업로드한 이미지가 브라우저 안에 남으며 클라이언트는 시연 전용이라고 설명합니다.
deepseek-flash의 다섯 가지 채팅 내 기능은 어떻게 작동하나요?
다섯 가지 채팅 내 기능은 모두 세 API 엔드포인트를 통해 deepseek-flash에서 실행됩니다. DeepSeek 가격 페이지에는 현재 DeepSeek-V4.1-Flash-1017로 표시됩니다.
- Messages (Anthropic 형식):
POST https://api.deepseek.com/anthropic/v1/messages - Responses:
POST https://api.deepseek.com/responses - Chat Completions:
POST https://api.deepseek.com/chat/completions
Build a Chatbot 가이드와 Web Tools 가이드에 따르면 각 기능은 특정 요청 설정에 대응합니다.
- 웹 검색: 사고 기능을 끄고
deepseek_web_search도구를 켜면deepseek-flash가 필요에 따라 웹이나 이미지를 검색하고 출처를 인용해 답합니다. 사용자 메시지에 이미지가 있으면 이미지 검색이 자동으로 실행됩니다. - 심층 사고 검색: 사고 기능과
deepseek_web_search를 함께 켜면 모델이 여러 추론 단계에 걸쳐 자율적으로 웹을 검색하고 링크를 읽으며, 답하기 전에 최대 약 20회 도구를 호출합니다. - URL 읽기:
deepseek_read_url을 켜면 모델이 사용자 프롬프트의 링크를 감지하고 페이지를 가져와 답변 컨텍스트에 포함합니다. - 파일 입력: Files API로 PDF, Office 문서, 이미지 등 파일을 업로드하면
text_recognition(일반 텍스트만 처리하고 차트와 사진 제외) 또는rich_layout_recognition(텍스트와 잘라낸 그림을 원래 위치에 배치)으로 분석해 컨텍스트에 넣습니다. - 모델 안전성:
safety_check를 추가하면 입력과 출력을 검사하고 위험이 감지될 때 거부 표시를 반환합니다.
챗봇 가이드는 선택적 사용자 메타데이터 표시자(현재 날짜, 사용자 위치와 언어 전달)와 title을 통한 대화 제목 자동 생성도 설명합니다. 클라이언트 애플리케이션은 반환된 콘텐츠 블록을 표시하고 다음 턴에 변경 없이 다시 보내야 합니다. DeepSeek가 검색 호출과 컨텍스트 구성을 서버에서 처리하므로, 애플리케이션이 각 도구 호출을 로컬에서 실행하는 기존의 클라이언트 측 도구 호출과 다릅니다.
요청에서 DeepSeek API 웹 검색을 활성화하려면?
개발자는 다음 매개변수를 deepseek-flash JSON 요청 본문에 직접 추가해 DeepSeek 웹 검색, URL 읽기, 높은 수준의 안전성 검사, 대화 제목 자동 생성을 활성화합니다.
{
"model": "deepseek-flash",
"tools": [
{ "type": "deepseek_web_search" },
{ "type": "deepseek_read_url" }
],
"safety_check": { "level": "high" },
"title": { "enabled": true },
"messages": [
{
"role": "user",
"content": "Summarize the latest pricing updates on https://api-docs.deepseek.com/quick_start/pricing"
}
]
}요청에서 웹 도구를 선언하거나 safety_check를 high로 설정하거나 title을 활성화하면 DeepSeek 서비스가 여러 샘플링 매개변수를 덮어쓰고 temperature, top_p 같은 클라이언트 값을 무시합니다. max_tokens 매개변수는 계속 적용되지만 여러 단계로 이루어진 전체 검색이 아니라 각 추론 단계에 개별적으로 상한을 둡니다.
독립적인 DeepSeek Search, Fetch, OCR, ASR, TTS API
DeepSeek는 통합 채팅 기능과 함께 네 가지 독립 API를 공개해 개발자가 채팅 세션 밖에서 검색, 페이지 추출, OCR, 음성 처리를 호출할 수 있도록 했습니다.
Search와 Fetch API
Search & Fetch 가이드에 설명된 대로 POST https://api.deepseek.com/v1/tools/search는 DeepSeek 웹 색인을 직접 검색하고 POST https://api.deepseek.com/v1/tools/fetch는 웹 페이지를 Markdown으로 가져옵니다. 채팅 내 deepseek_web_search 도구와 달리 독립적인 Search API는 아직 이미지 검색을 지원하지 않습니다.
DeepSeek OCR API
POST https://api.deepseek.com/v1/tools/ocr에서 제공되는 OCR API는 PDF, Word, PowerPoint와 일반적인 이미지 형식을 지원하고 추출한 텍스트를 페이지별로 반환합니다. OCR 엔드포인트로 보낸 파일은 DeepSeek에 저장되지 않으며 채팅 모델에도 전달되지 않습니다.
DeepSeek ASR (음성을 텍스트로)
POST https://api.deepseek.com/v1/tools/asr에서 제공되는 ASR API는 16비트 PCM WAV 또는 Ogg Opus 오디오 파일 전체를 한 번의 요청으로 텍스트로 변환하며 스트리밍 인식은 지원하지 않습니다. 중국어, 광둥어, 영어, 일본어, 한국어, 독일어, 프랑스어, 스페인어, 포르투갈어, 이탈리아어, 러시아어, 아랍어, 힌디어를 포함한 21개 언어를 자동 감지합니다.
DeepSeek TTS (텍스트를 음성으로)
전체 텍스트 합성 또는 WebSocket 스트리밍을 위해 POST https://api.deepseek.com/v1/tools/tts로 이용할 수 있는 TTS API는 stella(여성, 기본값)와 tide(남성) 두 가지 음성을 제공합니다. 만다린, 광둥어, 영어, 일본어, 한국어, 말레이어, 아랍어, 인도네시아어, 태국어, 베트남어 등 10개 언어를 자동 감지하고 기본적으로 wav 또는 pcm으로 출력합니다.
DeepSeek API 웹 검색, OCR, 음성의 가격은 얼마인가요?
DeepSeek의 공식 Models & Pricing 페이지에 따르면 2026년 11월 15일 기준 모든 도구 및 독립 API 호출은 deepseek-flash 모델 토큰 요금에 더해 과금됩니다.
도구 및 독립 API 가격
| 항목 | 가격 | 단위 | 비고 |
|---|---|---|---|
| 검색 (텍스트와 이미지) | $0.75 | 검색 1,000회당 | 웹 도구와 Search API 가격 동일 |
| 웹 가져오기 | $0.75 | 가져오기 1,000회당 | URL 읽기와 Fetch API 가격 동일 |
| 파일 분석과 OCR API | $0.225 | 1,000페이지당 | 분석한 페이지마다 과금 |
| 텍스트 음성 변환 (TTS) | 정가 $0.45 / 기간 한정 $0.225 | 10,000자당 | 기간 한정 50% 할인 |
| 음성 텍스트 변환 (ASR) | 정가 $0.116 / 기간 한정 $0.058 | 오디오 1시간당 | 기간 한정 50% 할인 |
deepseek-flash 토큰 가격 (1M 토큰당)
| 토큰 유형 | 비혼잡 시간 | 혼잡 시간 |
|---|---|---|
| 입력 (캐시 적중) | $0.003 | $0.006 |
| 입력 (캐시 미스) | $0.15 | $0.30 |
| 출력 | $0.60 | $1.20 |
deepseek-flash는 1M 토큰 컨텍스트 창과 최대 384K 출력 토큰을 지원합니다. 비혼잡 시간의 토큰 가격은 혼잡 시간 가격의 절반입니다. 혼잡 시간은 중국 공휴일을 제외한 월요일부터 금요일까지 01:0004:00 UTC와 06:0010:00 UTC이며, 그 외 시간과 주말에는 비혼잡 요금이 적용됩니다. DeepSeek는 TTS와 ASR의 50% 할인 종료일을 발표하지 않았으며 가격이 달라지고 조정될 수 있다고 밝혔습니다. 제공업체별 토큰 요금에 대한 더 넓은 비교는 AI API 가격 비교를 참조하세요.
개발자를 가장 놀라게 하는 과금 규칙은 무엇인가요?
DeepSeek의 과금 모델은 단순한 엔드포인트 호출 수가 아니라 개별 하위 검색어, 성공한 가져오기, 업로드한 페이지, 안전성 검토 토큰에 비용을 부과합니다.
- 검색은 도구 호출이 아니라 검색어별 과금: 검색어 세 개를 포함한
deepseek_web_search호출 한 번은 검색 세 건으로 과금됩니다. 이미지 검색에서는 이미지마다 한 건으로 계산하고 모델이 선택한 영역마다 한 건을 추가합니다. - 실패와 빈 결과는 무료: 실패한 검색, 빈 결과, 시간 초과, 가져오지 못한 링크에는 요금이 없습니다. 독립적인 Search와 Fetch 요청은 결과 수나 페이지 토큰 수에 관계없이 비어 있지 않은 결과를 담은 HTTP 200 응답에만 과금됩니다.
- 심층 사고 검색에서 다시 열기는 무료: 여러 단계의 추론 중 페이지는 웹에서 가져올 때만 과금됩니다. 가져온 페이지를 다시 열거나 탐색하거나 안에서 텍스트를 찾아도 추가 가져오기 요금이 없습니다.
- 안전성 검사는 출력 토큰으로 과금: 안전성 검토에 사용된 토큰은
safety_tokens로 보고되며 출력 토큰 요금으로 과금됩니다. - 파일 분석은 업로드 시 한 번 과금: 문서 분석은 업로드가 성공하면 페이지당 한 번 과금되며, 이후 파일을 참조하는 채팅 턴에는 표준 입력 토큰 요금이 적용됩니다.
- 음성 과금: ASR은 오디오 길이를 초 단위로 과금합니다.
주요 제한, 안전성 검사와 준수 의무
DeepSeek는 새 엔드포인트에 엄격한 페이로드 상한, 도구 제한과 준수 관련 주의사항을 적용합니다.
기술 및 동시 실행 제한
- 웹 도구:
deepseek_web_search는allowed_domains,blocked_domains,user_location을 지원하지 않습니다. 다른 서버 도구는 아직deepseek_web_search,deepseek_read_url,safety_check,title과 결합할 수 없습니다. 심층 사고 검색은 약 20회 도구 호출 후 중단됩니다. - 파일 분석과 OCR: 둘 다 파일을 100 MiB와 1,000페이지로 제한합니다. 파일 분석은 업로드 120초, 분석 120초, 계정당 동시 업로드 15건으로 제한하며 원본 파일과 분석 결과를 다운로드할 수 없습니다. 독립 OCR은 총 180초를 허용합니다.
- ASR과 TTS: ASR은 파일을 8 MiB와 120초로 제한하며 계정당 최대 50개의 동시 요청을 허용합니다. TTS는 요청당 과금 대상 10,000자로 제한하고 속도 조절을 지원하지 않습니다.
모델 안전성 검사와 공개 서비스 준수
기본적으로 API는 low 수준의 안전성 검사를 실행합니다. safety_check를 {"level": "high"}로 설정하면 입력(도구 결과 포함)과 출력 모두에 Model Content Safety 검토가 적용됩니다. 위반 시 400 Content Exists Risk를 반환하거나 거부와 함께 응답을 종료합니다(Messages에서는 stop_reason "refusal", Chat Completions에서는 finish_reason "content_filter"). 이미 스트리밍된 토큰은 회수할 수 없으므로 클라이언트는 거부가 도착하면 스트리밍된 텍스트를 자체 거부 메시지로 대체해야 합니다.
DeepSeek는 대중에게 서비스를 제공하는 운영자에게 safety_check를 활성화하고 콘텐츠 안전성 검토, 대형 모델 등록, AI 표시 등의 의무를 이행하도록 안내합니다. DeepSeek는 safety_check가 준수를 돕지만 서비스 제공자 자신의 콘텐츠 검토 의무를 대체하지는 않는다고 설명합니다.
채팅 내 웹 도구와 독립 Search 및 Fetch는 언제 사용해야 하나요?
DeepSeek의 채팅 내 웹 도구와 독립 Search 및 Fetch API 중 선택은 검색을 DeepSeek가 제어할지 자체 코드가 제어할지에 달려 있습니다. 서버가 관리하는 검색 조율, 이미지 검색, 여러 단계의 심층 사고, 자동 출처 표기가 유용한 대화형 도우미를 만든다면 deepseek-flash 내에서 deepseek_web_search와 deepseek_read_url을 사용하세요.
Markdown 페이지 추출 결과에 대해 자체 도메인 필터링, 청크 분할 또는 후속 모델 선택이 필요한 맞춤형 검색 증강 생성(RAG) 파이프라인을 만들 때는 독립적인 /v1/tools/search와 /v1/tools/fetch 엔드포인트를 사용하세요. 독립 OCR, ASR, TTS도 파일이나 오디오가 채팅 상태에 속하지 않는 모듈식 파이프라인에 적합합니다.
FAQ
어떤 DeepSeek 모델이 웹 검색과 URL 읽기를 지원하나요?
DeepSeek 문서는 Messages, Responses, Chat Completions 엔드포인트에서 deepseek-flash를 지정합니다(가격 페이지에는 현재 DeepSeek-V4.1-Flash-1017로 표시). 가이드에는 다른 모델 ID의 지원이 명시되지 않았으므로 서버가 처리하는 웹 검색, 심층 사고 검색, URL 읽기, 파일 입력, 안전성 검사가 필요한 개발자는 deepseek-flash를 사용해야 합니다.
DeepSeek 웹 검색을 특정 도메인으로 제한할 수 있나요?
아니요. DeepSeek의 Web Tools 가이드는 deepseek_web_search가 allowed_domains, blocked_domains, user_location을 지원하지 않는다고 확인합니다. 엄격한 도메인 허용 목록이나 차단 목록이 필요하다면 독립적인 /v1/tools/search API를 호출하고 반환된 URL을 자체 백엔드에서 필터링한 다음 /v1/tools/fetch로 승인된 페이지를 가져오세요.
DeepSeek API에서 실패한 검색이나 접근할 수 없는 URL에도 요금이 부과되나요?
아니요. DeepSeek는 웹 검색에서 검색어가 결과를 반환할 때만, URL 읽기에서는 페이지를 성공적으로 가져올 때만 과금합니다. 독립 Search와 Fetch API에서 시간 초과, 실패한 요청, 빈 결과는 무료이며 비어 있지 않은 페이로드를 가진 HTTP 200 응답에만 요청 1,000건당 $0.75가 부과됩니다.
DeepSeek의 TTS와 ASR 50% 할인은 언제까지인가요?
DeepSeek의 Models & Pricing 페이지에는 TTS를 10,000자당 $0.225, ASR을 오디오 1시간당 $0.058로 낮추는 기간 한정 50% 할인이 명시되어 있지만 종료일은 없습니다. DeepSeek는 가격이 달라질 수 있다고 밝히며 공개된 API 요금을 조정할 권리를 보유합니다.
safety_check를 활성화하면 공개 AI 서비스 준수 규칙을 충족하나요?
아니요. DeepSeek에 따르면 대중에게 서비스를 제공하는 운영자는 safety_check를 활성화하고 콘텐츠 안전성 검토, 대형 모델 등록, AI 표시 관련 의무를 이행해야 합니다. 문서에는 이 매개변수가 준수를 돕지만 서비스 제공자 자신의 콘텐츠 검토 책임을 대체하지 않는다고 명시되어 있습니다.
