/01
gPdf는 PDF를 얼마나 빨리 렌더링합니까?
1000회 호출 측정에서 단일 A4 페이지 p50은 3 ms, p99는 8 ms입니다. 네트워크 포함 엣지 wall time은 일반적으로 8-15 ms입니다.
FAQ
개발자가 실제로 묻는 질문.
12개 답변 — Google 리치 결과에서 사용하는 JSON-LD FAQPage와 동일한 내용입니다.
/02
API는 어떤 입력 형식을 받습니까?
JSON DocumentRequest 본문입니다. 페이지, 요소, 레이어, 워터마크, 헤더, 푸터, 테이블이 모두 구조적으로 표현됩니다 — HTML, Markdown, 브라우저 레이아웃 패스 없음.
/03
gPdf는 Puppeteer 또는 headless Chrome과 어떻게 비교됩니까?
Headless Chromium은 렌더당 200-800 ms 소요되며 800 MB 컨테이너가 필요합니다. gPdf는 동일한 A4 페이지를 1 MB V8 isolate에서 3 ms에 렌더링하며 콜드 스타트가 없습니다. 트레이드오프는 입력 형식입니다: gPdf는 JSON DocumentRequest를 받고 원시 HTML은 받지 않습니다.
/04
gPdf API 엔드포인트는 무엇입니까?
세 개: /api/v1/pdf/render는 픽셀 수준 제어를 위한 전체 DocumentRequest를 받습니다. /api/v1/template-render는 게시된 템플릿을 가진 시스템을 위해 template_id와 데이터 배열을 받습니다. /api/v1/e-invoice/render는 Factur-X / ZUGFeRD 하이브리드 인보이스(PDF/A-3 + 임베디드 XML)를 생성합니다. 세 개 모두 동일한 엔진, 동일한 속도 제한, 동일한 오류 코드 체계를 공유합니다.
/05
한국어, 일본어, 중국어를 위해 서버에 폰트를 설치해야 합니까?
아니요. NotoSans CJK가 내장되어 있고 자동 폰트 폴백 체인이 누락된 글리프를 처리합니다. 두부 박스를 절대 보지 못하며, 런타임에 apt install fonts-noto-cjk가 필요 없습니다.
/06
어떤 바코드를 렌더링할 수 있습니까?
QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode, Code 128을 포함한 30개 이상의 심볼로지. 모두 벡터. 바코드 전체 길이는 요청 크기의 0.1 mm 이내이며, GS1 및 ITF-14 규격의 라벨 폭에 충분히 정확합니다.
/07
gPdf는 PDF/A 또는 전자 인보이스 준수 출력을 생성합니까?
예. PDF/A-1b, 2b, 3b, 4를 요청별로 선택할 수 있습니다. 전자 인보이스 시나리오를 위한 Factur-X 및 ZUGFeRD 첨부 스트림을 지원합니다.
/08
gPdf는 Factur-X, ZUGFeRD 또는 EN 16931 전자 인보이스를 생성할 수 있습니까?
예. settings.profile을 pdfa-3b로 설정하고 구조화된 XML 페이로드를 파일 스트림으로 첨부하세요. Factur-X와 ZUGFeRD는 PDF/A-3 위에서 작동합니다 — 이미 시행 중인 독일 전자 인보이스 의무화와 2026년 9월부터의 프랑스 B2B 의무화에 필요합니다.
/09
gPdf는 실제로 어디서 실행됩니까?
Cloudflare Workers V8 isolate 내부. Chromium 컨테이너 없음, Lambda 워밍 없음, 요청 후 문서 영속화 없음.
/10
gPdf는 내 PDF 또는 입력 데이터를 저장합니까?
아니요. 렌더러는 stateless입니다. 귀하의 DocumentRequest는 렌더링의 몇 밀리초 동안 V8 isolate에 살고 그 다음 사라집니다. gPdf는 캐싱 계층도 문서 저장소도 없습니다 — stateless는 계약이지 옵트인 토글이 아닙니다.
/11
무료 티어가 있습니까?
예. Free Trial은 하루 100페이지, 신용카드 불필요. 매일 자동 리셋되며 쿼터에서 정지 — 예상치 못한 청구서가 없습니다. 유료 티어는 100,000페이지에 월 $5부터 시작합니다.
/12
gPdf 사용을 어떻게 시작합니까?
위의 playground를 열고 DocumentRequest를 편집한 뒤 PDF 생성을 누르세요 — 라이브 엣지 워커가 실제 PDF를 반환합니다. curl 스니펫을 터미널에 복사하면 어디서든 호출할 수 있습니다. Playground는 설치도 신용카드도 필요 없습니다. 자체 API 키를 발급받으려면 계정만 필요합니다.