v2026.05 · JSON → PDF 생성 API

세계에서 가장 빠른 API 대량 인보이스 및 배송 라벨용

$5로 10만 페이지. 엣지에서 PDF를 몇 밀리초 안에 생성

글로벌 확장을 위한 설계 PDF/A, Factur-X 및 ZUGFeRD 전자 인보이스 요건 완벽 준수

라이브 API 시도 API 레퍼런스 보기 신용카드 불필요 · 설치 불필요 · curl 친화적
CPU / 렌더 (p50)
4.98ms · 24h
처리된 요청
299/ 24h
비용
$5 / 100K
리전
300+ pops
30+ 바코드 형식 4개 PDF/A 프로파일 100K 페이지 월 $5부터
Playground

JSON을 보내고 PDF를 생성하세요.
핵심 기능을 한 페이지에.

왼쪽에서 DocumentRequest를 편집하고 라이브 엣지 Worker를 호출하세요
실제 schema, 실제 PDF, 보통 <5 ms.

왜 gPdf인가

gPdf는 네 가지 기둥 위에 세워져 있습니다.

01 / 04
$5
per 100K pages

비용

Cloudflare Workers 위에서 실행. 800 MB Chromium 컨테이너를 시간당 $0.40에 유휴 상태로 돌릴 필요가 없습니다. 페이지당 $0.00005, 최소 요금 없음, 좌석별 요금 없음, 환경별 추가 요금 없음.

02 / 04
PDF/A
1b · 2b · 3b · 4

표준 준수

PDF/A 아카이브 프로파일(1b / 2b / 3b / 4)을 요청 단위로 지정. Factur-X, ZUGFeRD, EN 16931 전자 인보이스를 네이티브 지원 — API 레퍼런스 §5에 명시, 로드맵 항목이 아닙니다.

03 / 04
JSON → PDF
API + editor, one schema

JSON 네이티브

pages[], elements[], x/y 단위는 밀리미터. HTML→PDF도, 헤드리스 Chrome도, 템플릿 DSL 학습도 필요 없습니다. 같은 JSON이 API와 비주얼 에디터를 동시에 구동 — 디자이너와 개발자가 같은 파일을 편집합니다.

04 / 04
3000+
color emoji, embedded

타이포그래피

Latin, CJK, 아랍어(RTL + 복합 합자), 데바나가리, 키릴, 벵골, 태국 문자를 엔진에 내장 — 3000+ 컬러 이모지까지 포함. `apt install fonts-noto-cjk` 불필요. 두부 문자(□) 영원히 없음.

기능

기본이지만 중요한 부분을 제대로.

PDF 래퍼 안의 브라우저 스크린샷이 아닌 실제 문서 시맨틱.

Browse use cases
/01

픽셀 단위 제어

x/y는 밀리미터, x_anchor로 우측 정렬, 라벨에서는 서브 밀리미터 배치. 좌표이지 근사값이 아닙니다.

// inside elements[i]
"x_anchor": {
  "reference": "content_right",
  "offset": 6
}
/02

벡터 바코드

GS1-128, QR, PDF417, DataMatrix를 포함한 30+ 심볼로지. 모두 벡터. 전체 길이 0.1 mm 정확도.

// 30+ formats: code128, qrcode, datamatrix, pdf417, ...
"type": "barcode",
"format": "code128",
"content": "INV-2026-001"
Why vector beats raster
/03

폰트 폴백 체인

font_mode 세 가지: strict(선언된 폰트가 모든 글리프를 커버해야 함), prefer(내장 폰트 체인으로 폴백), auto(엔진 선택). auto/prefer 모두 실패 시 API-504 반환 — 침묵 실패가 아닌 명시적 실패.

// inside style{}
"font_family": "NotoSans-Regular",
"font_mode": "prefer"
/04

컴플라이언스 모드

settings.profile = "pdfa-3b" 한 줄로 PDF/A-3b 준수와 Factur-X / ZUGFeRD가 요구하는 임베디드 XML 첨부 스트림이 모두 켜집니다. 한 필드, 한 준수 문서.

// top-level on DocumentRequest
"settings": {
  "profile": "pdfa-3b"
}
PDF/A and Factur-X, explained
/05

변수 + 페이지네이션

{page} / {total_pages}는 레이아웃 후 해결됨. keep_together, widow/orphan, page_break 블록.

// element of type "variable"
{ "type": "variable",
  "name": "page",
  "scope": "system" }
/06

페이지네이션하는 테이블

페이지를 넘는 row_span, 헤더 반복, alternate_fill, 복합 이중 테두리. 항상 깨지는 1%.

// inside table element
"pagination": {
  "keep_spans_together": true
}
/07

하나의 JSON, 두 인터페이스

같은 DocumentRequest JSON이 POST /api/v1/pdf/render와 editor.gpdf.com의 비주얼 에디터를 동시에 구동. 비주얼 편집, API 출력, 손으로 작성 — 세 경로가 같은 파일을 라운드트립합니다.

// three routes, one engine
POST /api/v1/pdf/render
POST /api/v1/template-render
POST /api/v1/e-invoice/render
Read the API reference
/08

인보이스를 위해 구축

페이지당 $0.00005, p50 3 ms, 내장 CJK, PDF/A-3 첨부 스트림. 핀테크, ERP, 세무 컴플라이언스 팀이 먼저 확인하는 네 숫자.

// invoice — header + table pattern
{ "size": "a4",
  "elements": [
    { "type": "text",  "x": 18, "y": 22, ... },
    { "type": "table", "x": 18, "y": 60, ... }
  ]}
Why JSON beats HTML→PDF
/09

배송 라벨을 위해 구축

label_100_150 및 label_4_6_in 크기 프리셋. 0.1 mm 정밀도의 벡터 GS1-128, ITF-14, SSCC. 운송사와 3PL은 피크 시간에도 래스터화된 바코드 없이 출력할 수 있습니다.

// 4×6 thermal shipping label
{ "size": "label_4_6_in",
  "elements": [{
    "type": "barcode",
    "format": "code128",
    "content": "1Z999AA10123456784" }]}
Shipping-label use case
벤치마크 · sampled 2026-04-29

측정된 것, 마케팅된 것이 아닙니다.

A4 1페이지 인보이스, 12개 항목, QR + 로고. 1000회 PDF 생성의 중앙값. 낮을수록 좋습니다.

Methodology: 1-page A4 invoice · 12 line items · 1 QR + 1 logo · 1K invocations · median (p50) and p99 reported. Sampled 2026-04-29 from a workstation in EU-WEST. PDFShift, DocRaptor, Puppeteer and LaTeX numbers are reproduced from each vendor's published quickstart sample with the same input — re-run on your own workload before deciding. Read the head-to-head comparisons →

0 105ms 210ms 315ms 420ms
01 gPdf ours
3.8ms
02 PDFShift
95ms
03 DocRaptor (Prince)
180ms
04 Puppeteer (headless)
312ms
05 LaTeX (local)
420ms
가격

페이지에 대해 지불하세요. 그 외에는 없습니다.

시트당 없음. 환경당 없음. 지원 티어 게이트키핑 없음.

모든 유료 티어는 동일한 100,000 페이지와 동일한 렌더 제한을 포함합니다. 메타데이터 사용자 정의, PDF/A 프로파일 가용성, 초과 요금에서만 차이가 있습니다.

Free Trial

/free
$0 영구

하루 100페이지 · 쿼터에서 정지.

  • +하루 100페이지 · 자동 리셋
  • +Playground + API 평가
  • +카드 불필요
  • +이메일 지원 · SLA 영업일 1일
Playground 시도

Basic

/basic
$5 / 월

100,000 페이지 포함.

  • +100,000 페이지 포함
  • +초과 페이지당 $0.00005
  • +표준 PDF 메타데이터 · 사용자 정의 불가
  • +표준 PDF만 · PDF/A 프로파일 없음
  • +이메일 지원 · SLA 영업일 1일
구독하기

Pro

/pro
$8 / 월

100,000 페이지 포함. 사용자 정의 메타데이터.

  • +100,000 페이지 포함
  • +초과 페이지당 $0.00008
  • +제목 · 주제 · 작성자 사용자 정의 가능
  • +표준 PDF만 · PDF/A 프로파일 없음
  • +이메일 지원 · SLA 영업일 1일
구독하기

Enterprise

/ent
$12 / 월

100,000 페이지 포함. PDF/A + 전체 메타데이터.

  • +100,000 페이지 포함
  • +초과 페이지당 $0.00012
  • +6개 메타데이터 필드 모두 완전 사용자 정의 가능
  • +PDF/A-1b · 2b · 3b · 4 활성화
  • +이메일 지원 · SLA 영업일 1일
구독하기
프라이빗 배포

자체 보안 경계 안에서 gPdf를 운영해야 하나요?

규제 대상 팀, 프라이빗 클라우드/VPC 배포, 격리된 인트라넷 환경을 위한 옵션입니다. gPdf를 전용 Worker, 서버 또는 게이트웨이 기반 배포로 운영하고, 네트워크 제어, 리전 요구사항, DPA 조건, 지원 에스컬레이션은 프로젝트별로 확정합니다.

  • +프라이빗 클라우드, VPC 또는 격리 네트워크
  • +전용 Worker/Server 배포
  • +DPA 조건 및 데이터 레지던시 제어
  • +지원 모델 사전 합의
프라이빗 배포 문의 · soon
FAQ

개발자가 실제로 묻는 질문.

12개 답변 — Google 리치 결과에서 사용하는 JSON-LD FAQPage와 동일한 내용입니다.

/01

gPdf는 PDF를 얼마나 빨리 렌더링합니까?

1000회 호출 측정에서 단일 A4 페이지 p50은 3 ms, p99는 8 ms입니다. 네트워크 포함 엣지 wall time은 일반적으로 8-15 ms입니다.

/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 키를 발급받으려면 계정만 필요합니다.

블로그에서

신선한 엔지니어링 에세이.

모든 게시물 보기
  1. 2026년에 PDF API를 고르는 법: 물어봐야 할 8가지 질문

    PDF 생성 API를 선택하기 위한 벤더 중립 의사결정 프레임워크. 12개월 뒤에도 만족할지를 가르는 8가지 질문입니다.

  2. gPdf vs DocRaptor: 왜 엣지 렌더링이 HTML-to-PDF를 이기는가

    DocRaptor는 호스팅된 백엔드에서 Prince를 사용해 HTML을 PDF로 변환합니다. gPdf는 Cloudflare 엣지에서 구조화된 JSON을 직접 렌더링합니다. 가격 격차는 18배입니다. 이것이 미끼가 아닌 이유를 설명합니다.

  3. 엔지니어를 위한 PDF/A와 Factur-X 설명 (법률 용어 없이)

    PDF/A 프로파일이 실제로 무엇을 제약하는지, 왜 Factur-X가 2026년에 EU에서 의무가 되는지, JSON 렌더러에서 컴플라이언스를 달성하기 위한 가장 작은 실용 파이프라인.

신뢰

컴플라이언스 및 데이터 거주

감사 가능한 엔지니어링과 문서 증빙을 함께 제공하며, 둘 다 검증 가능합니다.

SOC2

SOC 2 Type II

감사 2026년 Q3 예정 · 증거는 요청 시.

GDPR

GDPR + DPA

표준 계약 조항은 요청 시 사용 가능.

REGION

데이터 거주

EU, US, APAC, SA 데이터 레지던시 옵션. 리전 요구사항은 계약으로 확정합니다.

STATELESS

기본적으로 stateless

문서 영속화 없음. 제품에 캐시 계층이나 문서 저장소가 없습니다.

BENCHED

공개 벤치마크

이름이 명시된 경쟁자, 완전한 방법론, 샘플 날짜. 이 페이지의 모든 벤치마크는 재현 가능 — 결정 전 자체 워크로드에서 재실행하세요.

DETERMINISTIC

결정론적

동일한 입력 → 바이트 동일한 PDF. Diffable. 스냅샷 드리프트 없이 CI에서 테스트 가능.