Para desarrolladores

Una API de generación de imágenes que tus diseñadores pueden editar

Los diseñadores crean plantillas en un editor visual; tu código envía los datos por nombre de capa y recibe PNG, JPG, WEBP o PDF vectorial. Sin navegador headless que mantener y sin trucos de HTML a imagen.

Empieza gratis Ver la API

Plan gratuito para siempre. Sin tarjeta.

Una plantilla, una fila de datos por banner. Son renders reales.

title	price	badge
Auriculares Studio Pro	129 €	-20%
Buds Mini	49 €	NUEVO

Cómo funciona

1
Plantilla en el editor
Los nombres de las capas son los campos de la API: title, price, photo. Los diseñadores cambian el aspecto sin tocar tu código.
2
Una petición POST
Envía el ID de la plantilla y los valores de las capas. Con ?wait=true recibes la URL de la imagen en la misma respuesta.
3
Lotes y webhooks
Miles de elementos en un lote y webhooks render.completed y batch.completed con firma HMAC.

Cambia cualquier capa por su nombre

Texto, imagen, color, posición, tamaño, rotación y opacidad, o null para ocultar una capa. Las capas desconocidas no hacen fallar la petición: vuelven como avisos.

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

Lo que obtienes desde el primer día

Render idéntico al píxel

El editor y la API renderizan con el mismo componente en Chromium: fuentes, ajuste automático, degradados y códigos QR coinciden.

OpenAPI y documentación interactiva

La referencia completa está en /docs y la especificación OpenAPI se ofrece en JSON.

Informe de calidad por render

Cada respuesta enumera textos cortados o reducidos, imágenes ausentes o borrosas y capas fuera del lienzo.

Previsualizaciones gratuitas

preview: true renderiza con marca de agua y no consume tu cuota, ideal durante la integración.

Enlaces firmados

Inserta URLs /i/… en emails o páginas: la imagen se renderiza en la primera petición y se guarda en caché.

Servidor MCP para agentes de IA

Conecta Claude Code, Cursor y otros clientes MCP con la misma clave de API para listar, editar y renderizar plantillas.

Preguntas y respuestas

¿Qué tan rápido es un render?

La mayoría de los banners están listos en un segundo o dos. Las peticiones síncronas esperan hasta 30 segundos; para grandes volúmenes usa lotes y webhooks.

¿Qué formatos se admiten?

PNG, JPG y WEBP con ajuste de densidad de píxeles (scale), PDF vectorial con texto real y, para plantillas animadas, MP4, WebM o GIF.

¿Puedo probar la API gratis?

Sí. El plan gratuito incluye acceso a la API y 50 renders al mes, y las previsualizaciones son gratuitas en todos los planes.

Ver también

Imágenes OG dinámicas

Una imagen Open Graph única para cada página, desde una URL.

Anuncios de catálogo y dinámicos

Precio y descuento sobre las fotos de producto para anuncios de catálogo, actualizados desde el feed.

Cómo elegir una API de imágenes

Una checklist de lo que conviene probar antes de comprometerte con una API de imágenes.

Consigue tu clave de API en un minuto

Regístrate, crea una plantilla y haz tu primera petición.