TL;DR

  • Foliant는 Typst 소스를 한 번의 HTTP 요청으로 1초 미만에 PDF로 변환하며, 템플릿과 MCP 서버를 제공함.
  • 데모는 계정 없이 IP당 하루 3회, 회당 최대 5페이지까지 이용 가능하고, 이메일 로그인 무료 요금제는 매월 300페이지를 제공함.
  • API 응답은 PDF이며 페이지 수와 처리 시간은 헤더로 반환되고, 오류는 줄 번호를 포함한 JSON으로 반환됨.
  • MCP 서버는 원격 연결과 로컬 실행을 지원하며, check_source는 출력 없이 컴파일 진단을 수행하고 항상 무료임.
  • 요금제는 월 9 EUR부터 시작하며, 선불 크레딧은 페이지당 0.4센트이고 실패한 렌더링에는 요금이 부과되지 않음.

Typst를 PDF로 변환하는 데모

  • Typst 소스를 보내 인보이스, 보고서, 계약서, 인증서 등을 렌더링하는 API이며, 헤드리스 브라우저나 LaTeX 설치 없이 사용할 수 있음.
  • 데모는 계정 없이 하루 3회, 회당 최대 5페이지까지 렌더링하며, 인증된 엔드포인트와 같은 JSON 형식을 사용함.
  • 예시 출력은 A5 크기 1페이지 문서이며, Typst 0.15에서 75ms에 렌더링됨.
  • 데모 입력은 인증된 API와 같은 제작용 엔드포인트를 사용하되 페이지 제한이 더 낮음.

무료 API 키

  • 이메일로 로그인하면 계정과 첫 번째 API 키가 생성되며, 키는 대시보드에서 한 번 표시됨.
  • 무료 요금제는 매월 300페이지를 제공하며, 신용카드나 만료되는 체험 기간이 필요하지 않음.
  • 유료 계정과 출력 품질 및 API가 동일하며, 유료 플랜은 월 9 EUR부터 시작하거나 페이지당 0.4센트의 선불 크레딧을 사용할 수 있음.

요청 하나로 문서 하나 생성

  • Typst 소스와 참조 파일을 전송하면 응답 본문으로 PDF를 받으며, 페이지 수와 처리 시간은 응답 헤더에 포함됨.
  • 오류는 줄 번호를 포함한 JSON으로 반환됨.
  • Libertinus, New Computer Modern, DejaVu, Noto Sans 등의 폰트가 포함되며, TTF 또는 OTF 파일을 첨부하면 Typst가 해당 폰트를 사용함.
  • 기본 출력은 태그 구조가 포함된 PDF이며, 단일 페이지는 PNG와 SVG로도 출력 가능함.
  • 문서는 프랑크푸르트에서 렌더링 및 저장되며, 미국 엔드포인트도 제공됨.
  • API 엔드포인트는 https://api.foliant.dev/v1/render임.
  • 응답 헤더에는 콘텐츠 유형, 페이지 수, 사용 페이지 수, 페이지 한도가 포함됨. 예시 값은 application/pdf, 1, 41, 300임.

에이전트도 문서를 생성할 수 있음

  • MCP 서버는 모델에 render_document 도구를 제공하며, 모델이 Typst 문서를 작성하고 도구를 호출해 PDF를 반환하는 방식임.
  • 원격 MCP는 Claude, Cursor, Kiro에서 설치나 키 입력 없이 사용할 수 있으며, 클라이언트에서 로그인 및 승인을 마치면 연결 전용의 폐기 가능한 키가 생성됨.
  • 원격 MCP 주소는 https://api.foliant.dev/mcp임.
  • 로컬 실행은 npx -y @foliant/mcp를 사용하며 로컬 파일을 읽고 씀. /mcp/demo는 계정 없이 이용 가능함.
  • 제공 도구는 render_document(source | template, inputs?, format?, files?), check_source(...), save_template, get_template, list_templates, upload_asset, list_assets, account임.
  • check_source는 출력 파일을 만들지 않고 컴파일 진단만 수행하며, 사용량 한도에 포함되지 않음. 에이전트는 페이지를 사용하기 전에 오타를 수정하는 데 이를 활용할 수 있음.

템플릿에서 시작

  • 동일한 렌더링 엔진으로 생성되는 문서 템플릿 10종을 제공함.
  • 템플릿을 계정에 복사하고 데이터를 입력값으로 보내면 요청 주체와 관계없이 렌더링마다 같은 레이아웃을 유지함.
  • 예시 템플릿 범주는 인보이스, 계약서, 보고서, 서신이며 전체 템플릿은 10종임.

요금제

  • 데모: 무료이며 계정 없이 IP당 하루 3회, 회당 최대 5페이지까지 이용 가능함.
  • 무료: 월 300페이지이며, 문서당 최대 20페이지, 타임아웃 10초, 기본 제공 폰트, 최대 2MB 파일 첨부를 지원함.
  • Starter: 월 9 EUR, 3,000페이지 포함 후 페이지당 0.35센트이며, 문서당 최대 200페이지와 분당 120회 요청을 지원함.
  • Studio: 월 29 EUR, 12,000페이지 포함 후 페이지당 0.30센트이며, 문서당 최대 500페이지, 분당 300회 요청, 타임아웃 40초를 지원함.
  • Scale: 월 99 EUR, 50,000페이지 포함 후 페이지당 0.25센트이며, 문서당 최대 1,000페이지와 분당 600회 요청을 지원함.
  • 종량제: 플랜 없이 페이지당 0.4센트이며, 5 EUR부터 선불 충전 가능함. 5 EUR는 약 1,250페이지에 해당하고 크레딧은 만료되지 않음. 문서당 최대 200페이지와 8MB 파일을 지원하며, 플랜 사용자는 초과 요금보다 크레딧이 먼저 차감됨.
  • 플랜은 매월 갱신되며 기간 종료 시 언제든 취소할 수 있음. 포함 페이지는 이월되지 않으며 초과 요금은 다음 청구서에 반영됨.
  • 가격은 세금 별도이며 부가가치세가 포함된 청구서는 Stripe를 통해 발행됨. 실패한 렌더링에는 요금이 부과되지 않음.

자주 묻는 질문

  • Typst를 LaTeX나 HTML-to-PDF 대신 사용하는 이유: Typst는 밀리초 단위로 컴파일되며 하이픈 연결, 커닝, 표, 각주 등 타이포그래피 기능을 제공함. 문법이 읽기 쉬워 모델이 첫 시도부터 잘 작성할 수 있음. HTML-to-PDF는 브라우저가 필요하고 페이지 나누기가 부차적으로 처리됨. LaTeX는 같은 엔드포인트의 두 번째 엔진으로 로드맵에 포함되어 있으나 페이지당 속도는 더 느리고 비용은 더 높을 예정임.
  • 문서 보관 여부: 소스와 출력은 요청 처리 동안 메모리에만 존재하며 응답 전송 후 삭제됨. 로그에는 페이지 수와 처리 시간만 기록되고 문서 내용은 기록되지 않음.
  • Typst 레지스트리 패키지 사용 여부: 현재 지원되지 않음. 샌드박스에는 네트워크 접근이 없으며, 허용 목록 기반 패키지 지원은 크레딧 계정용으로 계획됨.
  • 실행 위치: AWS 프랑크푸르트(eu-central-1)에서 실행되며 계정 데이터, 저장된 템플릿과 에셋도 해당 지역에 보관됨. 미국 처리가 필요한 고객은 버지니아 북부에서 렌더링하는 us.api.foliant.dev 엔드포인트를 사용할 수 있음. 이 엔드포인트는 데이터를 저장하지 않으며 프랑크푸르트의 계정 데이터를 사용함. 각 렌더링은 아웃바운드 네트워크가 차단된 새 격리 샌드박스에서 실행됨.
  • 월중 무료 페이지 소진 시: 한도 초기화 날짜와 크레딧 충전 링크가 포함된 429 응답을 받음. 크레딧을 추가하면 코드를 변경하지 않고 같은 키를 계속 사용할 수 있음.