Reader
URL 앞에
r.jina.ai를 붙여 LLM 친화적인 입력으로 변환하세요.Reader API
URL 앞에
r.jina.ai를 붙여 LLM 친화적인 입력으로 변환하세요.globe_book
r.jina.ai로 URL을 읽고 콘텐츠를 가져오세요travel_explore
s.jina.ai로 웹을 검색하고 SERP를 얻으세요mcp.jina.ai를 MCP 서버로 추가하면 어떤 LLM에서든 저희 API를 호출할 수 있습니다콘텐츠 형식
Return-Format
과도한 필터링을 방지하기 위해 응답의 세부 정보 수준을 제어할 수 있습니다. 기본 파이프라인은 대부분의 사이트와 LLM 입력에 맞게 최적화되어 있습니다.
기본
arrow_drop_down
JSON 응답
Accept
응답은 JSON 형식이며 URL, 제목, 콘텐츠, 타임스탬프(사용 가능한 경우)를 포함합니다. 검색 모드에서는 각각 위에서 설명한 JSON 구조를 따르는 5개 항목의 목록을 반환합니다.
타임아웃(초)
X-Timeout
페이지 로딩 최대 대기 시간입니다. 페이지 로딩 속도가 느린 경우 이 값을 늘리고, 단순하고 정적인 페이지의 경우 이 값을 줄이세요.
토큰 예산
X-Token-Budget
이 요청에 사용되는 최대 토큰 수를 제한합니다. 이 제한을 초과하면 요청이 실패하게 됩니다.
jina-ocr-v1 사용
X-Respond-With
jina-ocr-v1을 사용하여 이미지를 Markdown으로 변환하며, 구조와 콘텐츠가 복잡한 페이지와 문서에서 고품질 결과를 제공합니다. 토큰이 40배 더 소모됩니다!open_in_new자세히 알아보기
페이지
X-Page
처리할 페이지입니다. 여러 페이지로 된 문서에서 지정된 페이지에 초점을 맞춥니다. PDF와 같은 문서를 처리할 때에만 적용됩니다.
지정 영역만 추출 (CSS 선택자)
X-Target-Selector
다음 CSS 선택자와 일치하는 콘텐츠만 추출하세요. 예: article, .main-content, #post-body
대기 대상 (CSS 선택자)
X-Wait-For-Selector
이러한 요소들이 나타난 후에만 콘텐츠를 추출하세요. 이는 동적으로 로드되는 콘텐츠에 매우 유용합니다.
제외 (CSS 선택자)
X-Remove-Selector
추출 전에 이러한 요소를 제거합니다. 예: nav, footer, .sidebar, #ads
모든 이미지 제거
X-Retain-Images
출력에서 모든 이미지를 제거합니다. 이렇게 하면 이미지가 필요하지 않을 때 토큰 사용량을 줄일 수 있습니다.
OpenAI 인용 형식
X-Retain-Links
OpenAI 웹 브라우징 도구에 맞는 링크 형식을 지정하세요. GPT 모델과 호환되는 특수 참조 태그를 사용하세요.open_in_new자세히 알아보기
링크 요약 섹션
X-With-Links-Summary
마지막에 “버튼 및 링크” 섹션이 추가됩니다. 다운스트림 LLM과 웹 에이전트가 페이지를 탐색하거나 추가 작업을 하는 데 도움이 됩니다.
없음
arrow_drop_down
이미지 요약 섹션
X-With-Images-Summary
마지막에 “이미지” 섹션이 추가됩니다. 다운스트림 LLM이 페이지의 모든 시각 요소를 한눈에 볼 수 있어 추론에 도움이 될 수 있습니다.
없음
arrow_drop_down
쿠키 전달
X-Set-Cookie
저희 API 서버는 URL에 액세스할 때 사용자 정의 쿠키 설정을 전달할 수 있으며 이는 추가 인증이 필요한 페이지에 유용합니다. 쿠키가 포함된 요청은 캐시되지 않습니다.open_in_new자세히 알아보기
이미지 캡션
X-With-Generated-Alt
지정된 URL의 모든 이미지에 캡션을 붙이고, alt 태그가 없는 이미지에는 ‘Image [idx]: [caption]’을 alt 태그로 추가합니다. 이를 통해 다운스트림 LLM이 추론과 요약 같은 작업에서 이미지와 상호작용할 수 있습니다.
프록시 서버 사용
X-Proxy-Url
저희 API 서버는 사용자의 프록시를 활용하여 URL에 액세스할 수 있는데, 이는 특정 프록시를 통해서만 액세스할 수 있는 페이지에 유용합니다.open_in_new자세히 알아보기
국가별 프록시 서버 사용
X-Proxy
위치 기반 프록시 서버의 국가 코드를 설정합니다. 최적 선택은 ‘auto’, 비활성화는 ‘none’을 사용하세요.
캐시 무시
X-No-Cache
저희 API는 일정 시간 동안 URL 콘텐츠를 캐시합니다. 캐시된 결과를 무시하고 URL에서 직접 콘텐츠를 가져오려면 true로 설정하세요.
캐시 허용 시간(초)
X-Cache-Tolerance
N초 이내에 캐시된 콘텐츠는 그대로 사용합니다. 0으로 설정하면 항상 새 콘텐츠를 가져오고(캐시 무시와 동일), 값을 키우면 캐시에서 더 빠르게 응답할 수 있습니다.
페이지 준비 시점
X-Respond-Timing
페이지가 완전히 로드되었다고 판단하는 시점입니다. 뒤쪽 옵션일수록 더 오래 기다리지만 동적 콘텐츠를 더 많이 담습니다.
기본
arrow_drop_down
사용자 지정 User-Agent
X-User-Agent
브라우저 사용자 에이전트 문자열을 재정의합니다. 특정 브라우저를 필요로 하거나 웹 크롤러를 차단하는 웹사이트에 접속할 때 매우 유용합니다.
사용자 지정 Referer
X-Referer
HTTP Referer 헤더를 설정하세요. 일부 웹사이트는 트래픽이 예상한 출처에서 왔는지 확인하기 위해 이 헤더를 확인합니다.
Base64 이미지 유지
X-Keep-Img-Data-Url
인라인으로 삽입된 base64 인코딩 이미지를 외부 URL로 변환하는 대신, 마크다운 출력에 그대로 유지하세요.
캐시 및 추적 안 함
DNT
이 요청이 저희 서버에 캐시되거나 기록되지 않도록 합니다. 민감한 URL에 사용하세요.
GitHub Flavored Markdown
X-No-Gfm
GFM(GitHub Flavored Markdown) 기능을 옵트인/아웃합니다.
활성화됨
arrow_drop_down
스트리밍 모드
Accept
스트리밍 모드는 대상 페이지가 클 때 유용하며, 페이지가 완전히 렌더링될 때까지 더 오래 기다립니다. 표준 모드에서 콘텐츠가 불완전하다면 스트리밍 모드 사용을 고려해 보세요.open_in_new자세히 알아보기
브라우저 로케일 사용자 지정
X-Locale
페이지 렌더링을 위한 브라우저 로케일 설정을 제어합니다. 많은 웹사이트는 로케일 설정에 따라 다양한 콘텐츠를 제공합니다.open_in_new자세히 알아보기
robots.txt 준수
X-Robots-Txt
콘텐츠를 가져오기 전에 robots.txt 규칙을 확인합니다. 확인에 사용할 봇 이름을 지정하세요.
iframe 콘텐츠 포함
X-With-Iframe
내장된 iframe에서 콘텐츠를 추출합니다. iframe 안에 콘텐츠가 로드되는 페이지에서 활성화하세요.
Shadow DOM 포함
X-With-Shadow-Dom
Shadow DOM 컴포넌트에서 콘텐츠를 추출합니다. 웹 컴포넌트를 사용하는 페이지에서 활성화하세요.
초기 URL을 기준으로 사용
X-Base
상대 URL을 해석할 때는 원래 URL이 아닌 리디렉션 후 최종 대상 URL을 사용하세요.
로컬 PDF/HTML 파일
POST
로컬 PDF 및 HTML 파일을 업로드하여 Reader로 읽을 수 있습니다. PDF와 HTML 파일만 지원됩니다. HTML의 경우 관련 CSS/JS 스크립트를 더 잘 파싱할 수 있도록 참조 URL도 함께 지정해 주세요.
upload
추출 전 JavaScript 실행
POST
콘텐츠를 추출하기 전에 사용자 지정 JavaScript 코드를 실행하여 페이지를 수정하세요. 이 코드는 인라인 코드이거나 스크립트 파일을 가리키는 URL일 수 있습니다.open_in_new자세히 알아보기
제목 스타일
X-Md-Heading-Style
마크다운 제목 형식을 설정합니다(Turndown에 전달됨).
Hash Style
arrow_drop_down
수평선 스타일
X-Md-Hr
마크다운 수평선 형식을 정의합니다(Turndown에 전달됨).
글머리 기호 스타일
X-Md-Bullet-List-Marker
글머리 기호 목록 표시 문자를 설정합니다(Turndown에 전달됨).
*
arrow_drop_down
강조 스타일
X-Md-Em-Delimiter
마크다운 강조 구분 기호를 정의합니다(Turndown에 전달됨).
_
arrow_drop_down
강한 강조 스타일
X-Md-Strong-Delimiter
마크다운 강한 강조 구분 기호를 설정합니다(Turndown에 전달됨).
**
arrow_drop_down
링크 스타일
X-Md-Link-Style
마크다운 링크 형식을 결정합니다(Turndown에 전달됨).
Inline
arrow_drop_down
EU 데이터 상주
실험적
활성화하면 이 요청의 인프라와 데이터 처리가 EU 내에 위치합니다.
curl "https://r.jina.ai/https://www.example.com"key
API 키
visibility_off
사용 가능한 토큰
0
jina-ocr-v1: 저비용 GPU에서 더 빠른 문서 파싱
3.4B 파라미터의 전문가 혼합(MoE) 문서 파싱 모델로, 토큰당 활성화되는 파라미터는 570M뿐입니다. 페이지 이미지를 입력받아 텍스트, 수식, 표, 읽기 순서가 담긴 Markdown을 단일 패스로 반환합니다.
웹 정보를 LLM에 공급하는 것은 그라운딩의 중요한 단계지만 쉽지 않은 일입니다. 가장 단순한 방법은 웹페이지를 스크래핑해서 원시 HTML을 그대로 넣는 것입니다. 하지만 스크래핑은 복잡하고 자주 차단되며, 원시 HTML에는 마크업이나 스크립트 같은 불필요한 요소가 가득합니다. Reader API는 URL에서 핵심 콘텐츠를 추출해 깔끔한 LLM 친화적 텍스트로 변환함으로써 이러한 문제를 해결하고, 에이전트 및 RAG 시스템에 고품질 입력을 보장합니다. Reader API는 개발자 인프라입니다. 사용자가 제공한 URL을 LLM 친화적인 텍스트로 변환해 직접 검색, RAG, 에이전트 시스템을 구축할 수 있게 해줍니다. 일반 소비자용 검색 엔진이 아니며 사용자를 대신해 웹을 색인하거나 순위를 매기지 않습니다. 어떤 URL을 처리할지는 사용자가 제어하며, 결과물의 사용 방식에 대한 책임도 사용자에게 있습니다.
URL을 입력하세요
Reader URL
원시 HTML
Reader 출력
질문하기
Reader는 SERP API로 사용할 수 있습니다. 검색 엔진 결과 페이지 뒤에 있는 콘텐츠를 LLM에 입력할 수 있게 해줍니다. 쿼리 앞에
https://s.jina.ai/?q=를 붙이기만 하면 Reader가 웹을 검색하여 상위 5개 결과의 URL과 콘텐츠를 반환하며, 각 결과는 깔끔한 LLM 친화적 텍스트로 제공됩니다. 이를 통해 LLM을 항상 최신 상태로 유지하고 사실성을 높이며 환각을 줄일 수 있습니다.쿼리를 입력하세요
Reader URL
info 위의 데모와 달리, 실제로는 그라운딩을 위해 원래 질문을 그대로 웹에서 검색하지 않습니다. 흔히 하는 방식은 원래 질문을 다시 쓰거나 멀티홉 질문을 사용하는 것입니다. 검색된 결과를 읽은 뒤 필요에 따라 추가 쿼리를 만들어 더 많은 정보를 모으고, 그다음에 최종 답에 도달합니다.
웹페이지의 이미지에는 Reader 내부의 시각 언어 모델을 사용하여 자동으로 캡션이 생성되고, 출력물에서는 이미지 alt 태그 형식으로 제공됩니다. 이를 통해 다운스트림 LLM이 해당 이미지를 추론 및 요약 과정에 통합할 수 있는 충분한 힌트를 얻습니다. 즉, 이미지에 대해 질문하거나, 특정 이미지를 선택하거나, 심층 분석을 위해 더 강력한 VLM에 이미지 URL을 전달할 수도 있습니다!
네, Reader는 기본적으로 PDF 읽기를 지원합니다. 이미지가 많은 PDF를 포함해 대부분의 PDF와 호환되며 매우 빠릅니다! LLM과 결합하면 ChatPDF나 문서 분석 AI를 순식간에 손쉽게 구축할 수 있습니다.
가장 좋은 점은? 바로 무료라는 것입니다!
Reader API는 무료로 사용할 수 있으며 유연한 속도 제한과 가격을 제공합니다. 확장 가능한 인프라 위에 구축되어 높은 접근성, 동시성, 안정성을 제공합니다. 저희는 LLM을 위한 최선의 그라운딩 솔루션이 되고자 노력합니다.
속도 제한
속도 제한은 두 가지 방식으로 추적됩니다. RPM(분당 요청 수)과 TPM(분당 토큰 수)입니다. 제한은 IP 또는 API 키별로 적용되며, RPM 또는 TPM 임계값에 도달하는 즉시 적용됩니다. 요청 헤더에 API 키를 제공하면 IP 주소 대신 키별로 속도 제한을 추적합니다.
열
arrow_drop_down
| Product | API Endpoint | Descriptionarrow_upward | w/o API Keykey_off | w/ Free API Keykey | w/ Paid API Keykey | w/ Premium API Keykey | Average latency | Token Usage Counting | HTTP Method | |
|---|---|---|---|---|---|---|---|---|---|---|
| Reader API | https://r.jina.ai | Converts a URL to LLM-friendly text | 20 RPM | 500 RPM | 500 RPM | trending_up5000 RPM | 7.9s | Count the number of tokens in the output response. | GET/POST | |
| Reader API | https://s.jina.ai | Search the web and convert results to LLM-friendly text | block | 100 RPM | 100 RPM | trending_up1000 RPM | 2.5s | Every request costs a fixed number of tokens, starting from 10,000 tokens | GET/POST | |
| Embeddings API | https://api.jina.ai/v1/embeddings | Convert text/images to fixed-length vectors | block | 100 RPM & 100,000 TPM | 500 RPM & 2,000,000 TPM | trending_up5,000 RPM & 50,000,000 TPM | ssid_chart depends on the input size help | Count the number of tokens in the input request. | POST | |
| Reranker API | https://api.jina.ai/v1/rerank | Rank documents by query | block | 100 RPM & 100,000 TPM | 500 RPM & 2,000,000 TPM | trending_up5,000 RPM & 50,000,000 TPM | ssid_chart depends on the input size help | Count the number of tokens in the input request. | POST |
당황하지 마세요! 새 API 키에는 1,000만 토큰이 무료로 포함됩니다!
API 요금
API 가격은 토큰 사용량에 따라 결정됩니다. 하나의 API 키로 모든 Search Foundation 제품에 액세스할 수 있습니다.
Reader API 사용 비용은 얼마인가요?
keyboard_arrow_down
Reader API는 어떻게 작동하나요?
keyboard_arrow_down
Reader API는 오픈 소스인가요?
keyboard_arrow_down
Reader API의 일반적인 지연 시간은 얼마나 되나요?
keyboard_arrow_down
페이지를 직접 스크래핑하는 대신 Reader API를 사용해야 하는 이유는 무엇인가요?
keyboard_arrow_down
Reader API는 여러 언어를 지원하나요?
keyboard_arrow_down
Reader API는 웹사이트 접근 제어를 준수하나요?
keyboard_arrow_down
Reader API가 PDF 파일에서 콘텐츠를 추출할 수 있나요?
keyboard_arrow_down
Reader API가 웹페이지의 미디어 콘텐츠를 처리할 수 있나요?
keyboard_arrow_down
로컬 HTML 파일에서 Reader API를 사용할 수 있나요?
keyboard_arrow_down
Reader API는 콘텐츠를 캐시합니까?
keyboard_arrow_down
로그인 후 Reader API를 사용하여 콘텐츠에 액세스할 수 있나요?
keyboard_arrow_down
Reader API를 사용하여 arXiv의 PDF에 액세스할 수 있나요?
keyboard_arrow_down
Reader에서 이미지 캡션은 어떻게 작동하나요?
keyboard_arrow_down
Reader의 확장성은 어느 정도인가요? 프로덕션에서 사용할 수 있나요?
keyboard_arrow_down
Reader API의 속도 제한은 어떻게 되나요?
keyboard_arrow_down
ReaderLM이란 무엇인가요? 어떻게 사용하나요?
keyboard_arrow_down
웹 페이지에서 구조화된 데이터를 추출하는 방법은 무엇인가요?
keyboard_arrow_down
Reader가 웹사이트의 봇 방지 시스템을 능동적으로 우회하나요?
keyboard_arrow_down
무료 API 키에서 유료 API 키로 업그레이드하면 더 많은 웹사이트에 접속할 수 있나요?
keyboard_arrow_down
자체 인프라에서 Reader를 실행할 수 있나요?
keyboard_arrow_down
속도 제한
속도 제한은 두 가지 방식으로 추적됩니다. RPM(분당 요청 수)과 TPM(분당 토큰 수)입니다. 제한은 IP 또는 API 키별로 적용되며, RPM 또는 TPM 임계값에 도달하는 즉시 적용됩니다. 요청 헤더에 API 키를 제공하면 IP 주소 대신 키별로 속도 제한을 추적합니다.
열
arrow_drop_down
| Product | API Endpoint | Descriptionarrow_upward | w/o API Keykey_off | w/ Free API Keykey | w/ Paid API Keykey | w/ Premium API Keykey | Average latency | Token Usage Counting | HTTP Method | |
|---|---|---|---|---|---|---|---|---|---|---|
| Reader API | https://r.jina.ai | Converts a URL to LLM-friendly text | 20 RPM | 500 RPM | 500 RPM | trending_up5000 RPM | 7.9s | Count the number of tokens in the output response. | GET/POST | |
| Reader API | https://s.jina.ai | Search the web and convert results to LLM-friendly text | block | 100 RPM | 100 RPM | trending_up1000 RPM | 2.5s | Every request costs a fixed number of tokens, starting from 10,000 tokens | GET/POST | |
| Embeddings API | https://api.jina.ai/v1/embeddings | Convert text/images to fixed-length vectors | block | 100 RPM & 100,000 TPM | 500 RPM & 2,000,000 TPM | trending_up5,000 RPM & 50,000,000 TPM | ssid_chart depends on the input size help | Count the number of tokens in the input request. | POST | |
| Reranker API | https://api.jina.ai/v1/rerank | Rank documents by query | block | 100 RPM & 100,000 TPM | 500 RPM & 2,000,000 TPM | trending_up5,000 RPM & 50,000,000 TPM | ssid_chart depends on the input size help | Count the number of tokens in the input request. | POST |
API 관련 자주 묻는 질문
code
Jina의 모든 API에서 동일한 API 키를 사용할 수 있나요?
keyboard_arrow_down
code
API 키의 토큰 사용량을 볼 수 있나요?
keyboard_arrow_down
code
API 키를 잊어버린 경우 어떻게 해야 하나요?
keyboard_arrow_down
code
API 키가 만료되나요?
keyboard_arrow_down
code
API 키 간에 토큰 잔액을 전송할 수 있나요?
keyboard_arrow_down
code
내 API 키를 파기할 수 있나요?
keyboard_arrow_down
code
일부 모델의 첫 요청이 느린 이유는 무엇인가요?
keyboard_arrow_down
code
제 API 데이터가 모델 학습에 사용되나요?
keyboard_arrow_down
code
Jina API의 속도 제한은 어떻게 되나요?
keyboard_arrow_down
code
API에 배치 크기 제한이 있나요?
keyboard_arrow_down
code
Jina API는 Elastic 내 Jina 모델과 같은 것인가요?
keyboard_arrow_down
결제 관련 자주 묻는 질문
attach_money
API 요금은 문장 수나 요청 수에 따라 청구되나요?
keyboard_arrow_down
attach_money
신규 사용자가 무료 평가판을 받을 수 있나요?
keyboard_arrow_down
attach_money
실패한 요청에 대해 토큰이 차감되나요?
keyboard_arrow_down
attach_money
어떤 결제 방법을 지원하나요?
keyboard_arrow_down
attach_money
토큰 구매 시 송장을 발행받을 수 있나요?
keyboard_arrow_down
attach_money
API 토큰 대신 상업용 라이선스를 구매하려면 어떻게 해야 하나요?
keyboard_arrow_down
attach_money
신용카드 대신 송장이나 구매 주문서로 결제할 수 있나요?
keyboard_arrow_down
attach_money
결제는 완료했는데 잔액이나 속도 제한이 그대로입니다. 무엇을 확인해야 하나요?
keyboard_arrow_down
attach_money
해지, 자동 충전 중지, 저장된 결제 수단 삭제는 어떻게 하나요?
keyboard_arrow_down



