딥시크 검색 및 웹페이지 가져오기 도구 사용법 안내
1. 이게 뭔가요?
이 문서는 인공지능 프로그램이 최신 인터넷 정보를 스스로 찾고 읽을 수 있도록 딥시크가 제공하는 검색과 웹페이지 가져오기 기능의 사용법과 요금 제도를 설명하는 기술 안내서입니다. 여기서 응용 프로그램 프로그래밍 인터페이스란 서로 다른 프로그램이 대화할 수 있도록 돕는 규칙 모음을 뜻하며, 이를 통해 개발자는 인공지능이 실시간 정보를 검색하고 웹페이지 본문을 확인할 수 있는 기능을 만들 수 있습니다.
2. 왜 화제인가요?
인공지능 서비스가 최신 정보를 정확하게 제공하려면 외부 인터넷 자료를 스스로 가져오는 기능이 필수적입니다. 이 문서는 개발자가 인공지능 시스템을 안정적으로 구축할 수 있도록 접속 주소와 필수 입력 항목, 오류 발생 시 대처 방법, 그리고 투명한 요금 기준을 구체적으로 안내하므로 매우 중요합니다.
3. 핵심 내용
딥시크가 제공하는 검색 및 가져오기 도구는 프로그램 간 데이터 교환 표준인 제이슨 형식을 사용하며 기본 주소는 에이피아이 딥시크 닷컴입니다. 인증을 위해 요청 머리글에 비밀 형식의 에이피아이 열쇠와 콘텐츠 종류를 필수로 담아야 합니다. 머리글은 컴퓨터 간 통신에서 본문 외에 부가 정보를 전달하는 영역을 뜻하며, 이곳에 권한 인증 항목과 내용 종류를 적어 보냅니다. 검색 기능은 검색 주소로 포스트 방식을 이용해 요청하며, 사용자가 입력한 검색어에 맞는 웹페이지를 딥시크 자체 검색 엔진으로 찾아 정리된 결과로 돌려줍니다. 요청할 때 검색어는 필수이며 일백스물팔 자 이내의 유니코드 문자로 작성해야 하고 공백만 쓸 수는 없습니다. 돌려받을 결과 개수는 기본값 열 개이며 일에서 오십 사이로 지정할 수 있습니다. 그 외에도 검색을 유발한 원래 질문, 특정 지역을 맞추기 위한 아이피 주소, 본문을 함께 받아올지 결정하는 논리값을 선택적으로 넣을 수 있습니다. 요청 본문에 모르는 항목이 있어도 무시됩니다. 검색어에는 특정 사이트 제한, 사이트 제외, 단어 제외, 정확한 문구 일치, 언어 제한, 특정 날짜 이후나 이전 발행 페이지 제한 같은 다양한 연산자를 함께 쓸 수 있습니다. 검색 요청이 성공하면 정상 처리를 뜻하는 상태 코드 이백과 함께 결과 목록이 반환되며 결과가 없으면 빈 목록이 나옵니다. 응답 목록의 각 항목에는 재정렬 점수, 문서 제목, 주소, 화면 표시용 짧은 요약, 인공지능 모델용 긴 요약, 실제 본문 내용, 사이트 이름, 아이콘 주소, 발행 시각, 신뢰도 등급이 포함됩니다. 재정렬 점수는 관련성과 신뢰도, 최신순을 종합해 영부터 삼 사이의 숫자로 매기며 일점오점 이상이면 품질이 높은 결과로 봅니다. 신뢰도는 영부터 사 사이의 정수이며 삼 이상이면 매우 믿을 수 있는 출처를 뜻합니다. 가져오기 기능은 특정 웹페이지 하나를 불러와 읽기 쉬운 마크다운 형식으로 돌려주는 기능이며, 마크다운은 글의 제목과 본문 등을 간단한 기호로 표현하는 문서 작성 형식을 말합니다. 가져오기 요청에는 내용을 가져올 대상의 웹페이지 주소를 필수로 넣어야 하며, 주소는 팔천백구십이 자 이내여야 하고 에이치티티피나 에이치티에스 형식의 호스트를 포함해야 하며 사용자 이름이나 비밀번호를 넣으면 안 됩니다. 응답으로는 제목과 마크다운 형식의 본문 내용이 반환되지만, 대상 웹사이트의 서버 상태나 접근 허용 정책에 따라 영향을 받습니다. 오류가 발생하면 오픈에이아이와 호환되는 형식을 따르며 세부 변수 값은 비어 있습니다. 상태 코드 사백은 잘못된 형식이나 값에 문제가 있을 때, 사백일은 인증 열쇠가 없거나 틀렸을 때, 사백이십은 계정 잔액이 부족할 때, 사백삼은 보안 정책으로 거부되었을 때, 사백오는 주소가 없거나 차단되어 내용을 가져오지 못했을 때 발생합니다. 또한 사백팔은 읽기 시간 초과, 사백십삼은 요청 크기 초과, 사백십구는 초당 요청 수 한도 초과, 오백은 내부 서버 오류, 오백십구는 외부 서비스 응답 지연을 뜻합니다. 읽기 시간 초과나 초당 요청 수 초과, 오로 시작하는 오류가 발생하면 잠시 기다렸다 다시 요청하고 잔액 부족이면 충전 후 시도하며, 그 외 사십대 오류는 내용을 고치지 않고 다시 보내도 해결되지 않습니다. 요금은 주고받는 데이터 양이나 토큰 기준이 아니라 성공적으로 처리된 요청 건당 부과되며 검색과 가져오기 모두 성공한 요청 천 건당 영점칠구 달러입니다. 서버가 정상 처리를 뜻하는 상태 코드 이백을 반환하고 실제 검색 결과 목록이나 웹페이지 본문을 만들어냈을 때만 요금이 청구되며 실패하거나 빈 결과, 시간 초과는 청구되지 않습니다. 딥시크 하니스, 클로드 코드, 코덱스 같은 도구를 통해 서버가 자동으로 호출하는 검색과 가져오기 기능은 현재 무료이며 요금 청구는 베이징 시각 기준으로 이스턴이년 십일월 일일 영시부터 시작됩니다. 이용 한도는 각 계정마다 검색과 가져오기가 따로 적용되어 한쪽 트래픽이 많아도 다른쪽 사용 횟수가 줄지 않습니다. 검색과 가져오기 모두 각 계정마다 초당 최대 다섯 번까지 요청할 수 있으며 이 한도를 넘으면 사백십구 오류를 받습니다. 초당 요청 수 한도는 어떤 비밀 키를 쓰든 계정 단위로 계산되며 모델 동시 실행 허용량과 별개로 적용되고, 가져오기 기능은 계정 한도 외에 웹페이지 주소의 도메인별로도 초당 요청 수 한도가 따로 적용됩니다.
4. 나에게 어떤 영향이 있나요?
일반 사용자가 이 기술 문서를 직접 다룰 일은 없지만, 인공지능 프로그램이 최신 정보를 바탕으로 더 정확하고 신뢰할 수 있는 답변을 만들어내는 단단한 기반이 됩니다. 개발자와 기업은 이 지침서를 바탕으로 인공지능 시스템에 딥시크의 검색 및 가져오기 기능을 안정적으로 연동하고, 관련성 점수나 신뢰도 등급을 활용해 정보의 품질을 관리하며, 사용량 제한이나 오류 상황에 알맞은 예외 처리 코드를 구현하여 비용을 예측하고 시스템 중단을 막을 수 있습니다.