Для разработчиков

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

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

Бесплатный тариф навсегда. Без привязки карты.

data.csv
titlepricebadge
Наушники Studio Pro$129-20%
Buds Mini$49NEW
БЕСПРОВОДНЫЕ
Наушники Studio Pro
40 часов музыки на одном заряде
-20%
$129
БЕСПРОВОДНЫЕ
Buds Mini
40 часов музыки на одном заряде
NEW
$49
Один шаблон — одна строка данных на баннер. Это живые рендеры.

Как это работает

  1. 1

    Шаблон в редакторе

    Имена слоёв — это поля API: title, price, photo. Дизайнеры меняют внешний вид, не трогая ваш код.

  2. 2

    Один POST-запрос

    Отправьте ID шаблона и значения слоёв. С ?wait=true ссылка на картинку придёт в том же ответе.

  3. 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 рендеров в месяц, а превью-рендеры бесплатны на всех тарифах.

Смотрите также

Получите API-ключ за минуту

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