Dla programistów

API do generowania obrazów, którego szablony edytują graficy

Graficy budują szablony w edytorze wizualnym, Twój kod wysyła dane po nazwach warstw i dostaje PNG, JPG, WEBP lub wektorowy PDF. Bez własnej przeglądarki headless i bez sztuczek HTML-to-image.

Zacznij za darmo Zobacz API

Darmowy plan na zawsze. Bez karty płatniczej.

Jeden szablon — jeden wiersz danych na baner. To prawdziwe rendery.

title	price	badge
Słuchawki Studio Pro	499 zł	-20%
Buds Mini	199 zł	NOWOŚĆ

Jak to działa

1
Szablon w edytorze
Nazwy warstw to pola API: title, price, photo. Graficy zmieniają wygląd bez dotykania Twojego kodu.
2
Jedno żądanie POST
Wyślij ID szablonu i wartości warstw. Z ?wait=true link do obrazu wróci w tej samej odpowiedzi.
3
Paczki i webhooki
Tysiące elementów w jednej paczce i webhooki render.completed oraz batch.completed z podpisem HMAC.

Zmieniaj dowolną warstwę po nazwie

Tekst, obraz, kolor, pozycja, rozmiar, obrót i przezroczystość — albo null, by ukryć warstwę. Nieznane warstwy nie psują żądania, tylko wracają jako ostrzeżenia.

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
    }
  }'

Co dostajesz od razu

Render piksel w piksel

Edytor i API renderują tym samym komponentem w Chromium: fonty, autodopasowanie, gradienty i kody QR się zgadzają.

OpenAPI i interaktywna dokumentacja

Pełna dokumentacja pod /docs, specyfikacja OpenAPI dostępna jako JSON.

Raport jakości dla każdego renderu

Każda odpowiedź wymienia ucięty lub pomniejszony tekst, brakujące lub rozmyte obrazy i warstwy poza obszarem.

Darmowe podglądy

preview: true renderuje ze znakiem wodnym i nie zużywa limitu — wygodne podczas integracji.

Podpisane linki

Wstawiaj linki /i/… do maili lub stron: obraz renderuje się przy pierwszym żądaniu i trafia do cache.

Serwer MCP dla agentów AI

Podłącz Claude Code, Cursor i inne klienty MCP tym samym kluczem API, by przeglądać, edytować i renderować szablony.

Pytania i odpowiedzi

Jak szybki jest render?

Większość banerów jest gotowa w sekundę lub dwie. Żądania synchroniczne czekają do 30 sekund; przy dużych wolumenach używaj paczek i webhooków.

Jakie formaty są obsługiwane?

PNG, JPG i WEBP z ustawieniem gęstości pikseli (scale), wektorowy PDF z prawdziwym tekstem, a dla animowanych szablonów MP4, WebM lub GIF.

Czy mogę wypróbować API za darmo?

Tak. Darmowy plan obejmuje dostęp do API i 50 renderów miesięcznie, a podglądy są darmowe w każdym planie.

Zobacz także

Dynamiczne obrazy OG

Unikalny obraz Open Graph dla każdej strony z jednego linku.

Reklamy katalogowe i dynamiczne

Cena i rabat na zdjęciach produktów do reklam katalogowych, odświeżane z feedu.

Jak wybrać API do obrazów

Lista rzeczy do sprawdzenia, zanim wybierzesz API do obrazów.

Klucz API w minutę

Zarejestruj się, utwórz szablon i wyślij pierwsze żądanie.