DeepSeek의 검색 API와 가져오기 API는 성공한 요청 기준으로 과금되며, 성공한 요청 1,000회당 5위안입니다. 실패, 결과 없음, 시간 초과는 과금되지 않습니다. 이 두 인터페이스를 직접 호출하는 경우 2026년 10월 17일 출시 때부터 과금되었으며, Claude Code, Codex, DeepSeek Harness 안에서 발생하는 서버 측 호출도 베이징 시간 2026년 11월 1일 0시부터 횟수 기준으로 과금되기 시작했습니다. 11월 이후에도 무료로 계산하면 추가 비용이 발생합니다.
두 인터페이스, 역할 분담과 가격은 동일
Search는 키워드로 웹을 검색해 제목, 링크, 요약, 게시 시간을 반환하며, 한 번에 최대 50건까지 반환합니다. Fetch는 단일 웹페이지를 가져와 Markdown으로 변환합니다. 두 인터페이스는 동일한 DeepSeek API 키를 사용하며, 주소는 각각 공식 검색 인터페이스와 가져오기 인터페이스입니다. 과금은 요청 횟수 기준이며 토큰 기준도, 반환 건수 기준도 아닙니다. 성공만 과금 대상입니다. Search가 200을 반환하고 결과 배열이 비어 있지 않으면 1회로 계산하고, Fetch가 200을 반환하고 본문을 가져오면 1회로 계산합니다. 빈 결과, 400, 401, 402, 403, 404는 계산하지 않습니다.
오류와 속도 제한은 먼저 상태 코드로 처리
잔액이 부족하면 402가 반환되므로, 먼저 충전한 뒤 다시 시도하세요. 차감은 증정 잔액에서 먼저 이루어지고, 그 다음 충전 잔액에서 차감됩니다. 408, 429, 5xx는 잠시 기다렸다가 다시 시도하고, 다시 시도해 성공한 경우 정상적으로 과금됩니다. Fetch가 404를 반환하는 것은 대부분 대상 웹페이지를 열 수 없거나, 사이트 정책에 막혔거나, 본문을 추출할 수 없기 때문입니다. 요청을 바꿔도 소용없고, 무작정 다시 시도하면 시간만 낭비됩니다. 두 인터페이스는 계정당 각각 5 QPS로 제한되며, Fetch에는 도메인별 속도 제한도 있습니다. 대량으로 가져올 때는 먼저 대기열에 넣고 동시 실행 수를 조절하세요.
대량으로 실행하기 전에 비용을 계산해 두세요
검색 1회와 웹페이지 5건 가져오기는 성공한 요청 총 6회로, 도구 요금은 0.03위안입니다. 진짜 큰 비용은 그 뒤에 옵니다. 가져온 Markdown을 모델에 입력해야 하며, 토큰 요금은 별도로 부과됩니다. 인터페이스에는 페이지 나누기 필드가 없어, 같은 키워드를 반복해서 보내면 앞의 결과가 반복해서 반환될 뿐이며, 매번 과금됩니다. Claude Code에서 이 비용을 끄려면 설정에서 WebSearch를 거부 권한에 추가하세요. 먼저 소량으로 테스트해 결과가 쓸 만한지 확인한 뒤에 규모를 늘리세요. 도구 요금이 저렴하다고 해서 마음대로 다시 시도해도 되는 것은 아닙니다.
