Для розробників

API генерації зображень, шаблони якого редагують дизайнери

Дизайнери збирають шаблони у візуальному редакторі, ваш код надсилає дані за іменами шарів і отримує PNG, JPG, WEBP або векторний PDF. Без власного headless-браузера і без хаків HTML-to-image.

Почати безкоштовно Подивитися API

Безкоштовний тариф назавжди. Без прив’язки картки.

Один шаблон — один рядок даних на банер. Це живі рендери.

title	price	badge
Навушники Studio Pro	4 999 ₴	-20%
Buds Mini	1 899 ₴	NEW

Як це працює

1
Шаблон у редакторі
Імена шарів — це поля API: title, price, photo. Дизайнери змінюють вигляд, не чіпаючи ваш код.
2
Один POST-запит
Надішліть ID шаблону і значення шарів. З ?wait=true посилання на картинку прийде в тій самій відповіді.
3
Пакети й вебхуки
Тисячі елементів в одному пакеті й вебхуки render.completed та batch.completed з підписом HMAC.

Змінюйте будь-який шар за іменем

Текст, картинка, колір, позиція, розмір, поворот і прозорість — або null, щоб сховати шар. Невідомі шари не ламають запит, а повертаються як попередження.

request

curl -X POST "https://api.bannermatic.app/v1/renders?wait=true" \
  -H "Authorization: Bearer bm_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_promo",
    "format": "png",
    "layers": {
      "title": "Studio Pro headphones",
      "price": { "text": "$129", "color": "#FACC15" },
      "photo": "https://cdn.shop.com/p/123.jpg",
      "badge": null
    }
  }'

Що ви отримуєте одразу

Рендер піксель у піксель

Редактор і API рендерять одним компонентом у Chromium: шрифти, автопідгонка, градієнти й QR-коди збігаються.

OpenAPI та інтерактивна документація

Повний довідник — на /docs, специфікація OpenAPI доступна в JSON.

Звіт якості для кожного рендеру

Кожна відповідь перелічує обрізаний чи зменшений текст, відсутні чи розмиті картинки й шари за межами полотна.

Безкоштовні превью

preview: true рендерить з водяним знаком і не списує ліміт — зручно під час інтеграції.

Підписані посилання

Вставляйте посилання /i/… у листи чи сторінки: картинка рендериться при першому запиті й кешується.

MCP-сервер для AI-агентів

Підключіть Claude Code, Cursor та інші MCP-клієнти з тим самим API-ключем, щоб переглядати, правити й рендерити шаблони.

Питання та відповіді

Наскільки швидкий рендер?

Більшість банерів готові за секунду-дві. Синхронні запити чекають до 30 секунд; для великих обсягів використовуйте пакети й вебхуки.

Які формати підтримуються?

PNG, JPG і WEBP з налаштуванням щільності пікселів (scale), векторний PDF зі справжнім текстом, а для анімованих шаблонів — MP4, WebM або GIF.

Чи можна спробувати API безкоштовно?

Так. Безкоштовний тариф включає доступ до API і 50 рендерів на місяць, а превью-рендери безкоштовні на всіх тарифах.

Дивіться також

Динамічні OG-картинки

Унікальна Open Graph-картинка для кожної сторінки за посиланням.

Каталожна й динамічна реклама

Ціна і знижка на фото товарів для каталожної реклами, оновлення з фіда.

Як обрати API для зображень

Чек-лист того, що варто перевірити, перш ніж обрати API для зображень.

Отримайте API-ключ за хвилину

Зареєструйтеся, створіть шаблон і надішліть перший запит.