v2026.05 · API створення PDF з JSON

Найшвидший у світі API для масової генерації рахунків-фактур та етикеток

100 000 сторінок за 5 $. PDF створюються на edge-вузлах за кілька мілісекунд

Створено для глобального масштабу Повна відповідність вимогам 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 зліва. Викличте live edge worker
справжня схема, справжній PDF, зазвичай <5 мс.

Чому gPdf

gPdf тримається на чотирьох опорах.

01 / 04
$5
per 100K pages

Вартість

Працює на Cloudflare Workers — а не на 800 МБ контейнері Chromium, що простоює за $0,40/год. $0,00005 за сторінку. Без мінімумів, без оплати за місце, без націнок за середовище.

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

Стандарти

Архівні профілі PDF/A (1b, 2b, 3b, 4) на вимогу. Factur-X, ZUGFeRD та EN 16931 підтримуються нативно — Розділ 5 довідника API, а не пункт roadmap.

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

JSON-нативний

pages[], elements[], x/y у міліметрах. Без HTML→PDF, без headless Chrome, без DSL шаблонів для вивчення. Той самий JSON живить API та візуальний редактор — дизайнери й розробники редагують один файл.

04 / 04
3000+
color emoji, embedded

Типографіка

Latin, CJK, арабська (RTL + складне shaping), Devanagari, кирилиця, Bengali та Thai вбудовані в рушій — плюс 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

Векторні штрих-коди

30+ символік включно з GS1-128, QR, PDF417, DataMatrix. Усі векторні. Загальна довжина точна до 0,1 мм.

// 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 і вбудований потік XML-вкладень, які вимагають Factur-X / ZUGFeRD. Одне поле — один відповідний документ.

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

Змінні + пагінація

{page} / {total_pages} вирішуються після layout. keep_together, widow/orphan, блоки page_break.

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

Таблиці, що пагінуються

row_span між сторінками, повторювані заголовки, alternate_fill, складені подвійні межі.

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

Один JSON, дві поверхні

Той самий DocumentRequest JSON приводить у дію POST /api/v1/pdf/render та візуальний редактор на editor.gpdf.com. Редагуйте візуально, надсилайте через API або пишіть вручну — усі три маршрути round-trip один файл.

// 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 за page, p50 3 ms, вбудований CJK, потік вкладень PDF/A-3. Чотири числа, які fintech, ERP і tax-compliance teams перевіряють першими.

// 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. Векторні GS1-128, ITF-14, SSCC з точністю 0,1 мм — перевізники та 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
Ціни

Платіть за сторінки. Більше ні за що.

Без per-seat. Без per-environment. Без gatekeeping за рівнем підтримки.

Усі платні рівні включають однакові 100 000 сторінок і однакові ліміти рендерингу. Різняться лише налаштуванням метаданих, доступністю профілів PDF/A і тарифом перевищення.

Free Trial

/free
$0 назавжди

100 сторінок / день · зупиняється на квоті.

  • +100 сторінок / день · автоскид
  • +Playground + оцінка API
  • +Картка не потрібна
  • +Email-підтримка · SLA 1 робочий день
Спробувати Playground

Basic

/basic
$5 / місяць

100 000 сторінок / місяць включено.

  • +100 000 сторінок / місяць включено
  • +Перевищення $0.00005 за сторінку
  • +Стандартні метадані PDF · не налаштовуються
  • +Лише стандартний PDF · без профілів PDF/A
  • +Email-підтримка · SLA 1 робочий день
Оформити підписку

Pro

/pro
$8 / місяць

100 000 сторінок / місяць включено. Налаштовувані метадані.

  • +100 000 сторінок / місяць включено
  • +Перевищення $0.00008 за сторінку
  • +Заголовок · тема · автор налаштовуються
  • +Лише стандартний PDF · без профілів PDF/A
  • +Email-підтримка · SLA 1 робочий день
Оформити підписку

Enterprise

/ent
$12 / місяць

100 000 сторінок / місяць включено. PDF/A + повні метадані.

  • +100 000 сторінок / місяць включено
  • +Перевищення $0.00012 за сторінку
  • +Усі 6 полів метаданих повністю налаштовуються
  • +PDF/A-1b · 2b · 3b · 4 увімкнено
  • +Email-підтримка · SLA 1 робочий день
Оформити підписку
Приватний деплой

Потрібно розгорнути gPdf у власному периметрі?

Для регульованих команд, розгортань у private cloud/VPC та ізольованих інтранет-середовищ. gPdf можна запускати як виділений Worker, сервер або deployment за gateway; мережеві правила, вимоги до регіону, умови DPA та ескалація підтримки узгоджуються під проєкт.

  • +Private cloud, VPC або ізольована мережа
  • +Виділений Worker/server deployment
  • +Умови DPA та контроль резидентності даних
  • +Модель підтримки узгоджена заздалегідь
Контакт для приватного деплою · soon
FAQ

Питання, які розробники справді ставлять.

Дванадцять відповідей — цитуються дослівно JSON-LD FAQPage, який споживають Google rich results.

/01

Наскільки швидко gPdf рендерить PDF?

p50 — 3 мс, p99 — 8 мс на одній сторінці A4 при вимірюванні на 1000 викликах. Загальний edge-час із мережею зазвичай 8-15 мс.

/02

Який формат введення приймає API?

Тіло DocumentRequest у JSON. Сторінки, елементи, шари, водяні знаки, заголовки, нижні колонтитули та таблиці виражаються структурно — без HTML, без Markdown, без браузерного проходу layout.

/03

Як gPdf порівнюється з Puppeteer або headless Chrome?

Headless Chromium працює 200-800 мс на рендер і потребує контейнер 800 МБ. gPdf рендерить ту саму сторінку A4 за 3 мс усередині V8-isolate 1 МБ, без холодного старту. Компроміс — формат вводу: gPdf приймає JSON DocumentRequest, не сирий HTML.

/04

Які кінцеві точки API gPdf?

Три: /api/v1/pdf/render приймає повний DocumentRequest для попіксельного контролю. /api/v1/template-render приймає template_id плюс масив даних. /api/v1/e-invoice/render виробляє гібридні рахунки Factur-X / ZUGFeRD. Усі три використовують один рушій, ті самі ліміти запитів і ту саму поверхню кодів помилок.

/05

Чи потрібно встановлювати шрифти на сервер для китайської, японської або корейської?

Ні. NotoSans CJK вбудовано і автоматичний ланцюг fallback обробляє відсутні гліфи. Ви ніколи не побачите тофу-боксів і вам не потрібно apt install fonts-noto-cjk на runtime.

/06

Які штрих-коди я можу рендерити?

Понад 30 символік включно з QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode і Code 128. Усі векторні. Загальна довжина штрих-коду в межах 0,1 мм від запитаного розміру — достатньо точно для ширини етикеток за специфікаціями 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 payload як файловий потік. Factur-X та ZUGFeRD базуються на PDF/A-3 — це потрібно для чинного німецького мандату e-invoicing і французького B2B-мандату з вересня 2026.

/09

Де gPdf насправді працює?

Усередині V8-isolate Cloudflare Workers. Немає Chromium-контейнера, немає Lambda warming, немає персистентності документів після запиту.

/10

Чи зберігає gPdf мої PDF або вхідні дані?

Ні. Renderer stateless. Ваш DocumentRequest живе в V8-isolate декілька мілісекунд рендерингу, потім зникає. У gPdf немає шару кешування і сховища документів.

/11

Чи є безкоштовний рівень?

Так. Free Trial дає 100 сторінок на день, без кредитної картки. Скидається щодня і зупиняється на квоті. Платні рівні починаються від $5 на місяць за 100 000 сторінок.

/12

Як почати використовувати gPdf?

Відкрийте playground вище, відредагуйте DocumentRequest і натисніть Створити PDF — живий edge-worker повертає справжній PDF. Скопіюйте curl-сніпет у свій термінал, щоб викликати його звідки завгодно.

З блогу

Свіжі інженерні есеї.

Переглянути всі пости
  1. Як вибрати PDF API у 2026 році: 8 запитань

    Нейтральний фреймворк для вибору API генерації PDF. Вісім запитань, які показують, чи будете ви задоволені через 12 місяців.

  2. gPdf vs DocRaptor: чому edge rendering перемагає HTML-to-PDF

    DocRaptor використовує Prince для HTML-to-PDF на hosted backend. gPdf render structured JSON прямо на Cloudflare edge. Різниця ціни 18×, і це не teaser.

  3. PDF/A і Factur-X для інженерів без юридичної мови

    Що насправді обмежують профілі PDF/A, чому Factur-X важливий для європейських е-рахунків, і найменший практичний pipeline з JSON renderer.

Довіра

Відповідність та резидентність даних

Аудитована інженерія плюс паперова робота — обидва реєстри, обидва перевірювані.

SOC2

SOC 2 Type II

Аудит запланований Q3 2026 · докази на запит.

GDPR

GDPR + DPA

Стандартні договірні положення доступні на запит.

REGION

Резидентність даних

Варіанти резидентності даних EU, US, APAC і SA. Вимоги до регіону фіксуються в договорі.

STATELESS

Stateless за замовчуванням

Немає персистентності документів. У продукті немає шару кешу або сховища документів.

BENCHED

Публічні бенчмарки

Названі конкуренти, повна методологія, дата вибірки. Кожен бенчмарк на цій сторінці відтворюваний — перед рішенням повторіть на власному workload.

DETERMINISTIC

Детермінований

Той самий ввід → байт-ідентичний PDF. Diffable. Тестується в CI без дрейфу знімків.