Pentru dezvoltatori

Un API de generare a imaginilor pe care designerii îl pot edita

Designerii construiesc șabloane într-un editor vizual; codul tău trimite date după numele straturilor și primește PNG, JPG, WEBP sau PDF vectorial. Fără browser headless de întreținut și fără trucuri HTML-to-image.

Începe gratuit Vezi API-ul

Plan gratuit pentru totdeauna. Fără card.

Un șablon — un rând de date pentru fiecare banner. Acestea sunt randări reale.

title	price	badge
Căști Studio Pro	599 lei	-20%
Buds Mini	229 lei	NOU

Cum funcționează

1
Șablonul în editor
Numele straturilor sunt câmpurile API: title, price, photo. Designerii schimbă aspectul fără să atingă codul tău.
2
O singură cerere POST
Trimite ID-ul șablonului și valorile straturilor. Cu ?wait=true primești URL-ul imaginii în același răspuns.
3
Loturi și webhookuri
Mii de elemente într-un lot și webhookuri render.completed și batch.completed cu semnătură HMAC.

Schimbă orice strat după nume

Text, imagine, culoare, poziție, dimensiune, rotație și opacitate — sau null pentru a ascunde stratul. Straturile necunoscute nu blochează cererea, ci revin ca avertismente.

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

Ce primești din prima

Randare identică la pixel

Editorul și API-ul randează cu aceeași componentă în Chromium: fonturile, ajustarea automată, gradientele și codurile QR coincid.

OpenAPI și documentație interactivă

Referința completă este la /docs, iar specificația OpenAPI e disponibilă ca JSON.

Raport de calitate pentru fiecare randare

Fiecare răspuns listează textul tăiat sau micșorat, imaginile lipsă sau neclare și straturile în afara pânzei.

Previzualizări gratuite

preview: true randează cu filigran și nu consumă din cotă — util în timpul integrării.

Linkuri semnate

Inserează URL-uri /i/… în emailuri sau pagini: imaginea se randează la prima cerere și se păstrează în cache.

Server MCP pentru agenți AI

Conectează Claude Code, Cursor și alți clienți MCP cu aceeași cheie API pentru a lista, edita și randa șabloane.

Întrebări și răspunsuri

Cât de rapidă este o randare?

Majoritatea bannerelor sunt gata într-o secundă sau două. Cererile sincrone așteaptă până la 30 de secunde; pentru volume mari folosește loturi și webhookuri.

Ce formate sunt acceptate?

PNG, JPG și WEBP cu setarea densității de pixeli (scale), PDF vectorial cu text real, iar pentru șabloanele animate MP4, WebM sau GIF.

Pot încerca API-ul gratuit?

Da. Planul gratuit include acces la API și 50 de randări pe lună, iar previzualizările sunt gratuite în toate planurile.

Vezi și

Imagini OG dinamice

O imagine Open Graph unică pentru fiecare pagină, dintr-un URL.

Reclame de catalog și dinamice

Preț și reducere pe imaginile produselor pentru reclame de catalog, actualizate din feed.

Cum alegi un API pentru imagini

O listă cu ce să testezi înainte să alegi un API pentru imagini.

Obține cheia API într-un minut

Înregistrează-te, creează un șablon și trimite prima cerere.