Crear mi primera campaña
Aprobar y entregar · API y webhooks

Crea banners desde tu propio sistema, con una API.

Una API es la forma de pedir banners desde tu código. Pruébala sin gastar créditos y recibe un webhook (un aviso automático firmado) cuando el trabajo termina.

Crear mi primera campañaVer el tutorial
Ver la página para desarrolladores
POST /api/v1/bannersbm_test_…
Idempotency-Key: 7c1e9a52

{
  "prompt": "Tu mañana, bien tostada",
  "sizes": ["300x250", "728x90"],
  "locales": ["es-CR", "en-US"]
}

→ 202 { "jobId": "job_test_…", "status": "succeeded" }
Las claves de pruebas no gastan créditos.

Crea banners desde tu código

Un pedido con el prompt, los tamaños y los idiomas devuelve un trabajo que genera un concepto en todos ellos; lo consultas hasta que termine.

Avisos firmados

Registra un webhook y recibe un evento (banner generado, exportación lista, revisión aprobada…) con una firma que puedes verificar.

Seguro de probar

Las claves de pruebas devuelven un banner de muestra sin usar IA ni créditos. Si reintentas un pedido con la misma clave de idempotencia, no se cobra dos veces.

Cómo se usa

De la clave al banner, en tres pasos.

  1. Creas una clave

    De pruebas (bm_test_…) para empezar o de producción (bm_live_…). Se muestra completa una sola vez.

  2. Haces el pedido

    Envías el prompt, los tamaños y los idiomas, con un encabezado de idempotencia.

  3. Esperas el aviso

    Consultas el trabajo o recibes el webhook cuando el banner está listo.

Datos clave

Costos, límites y requisitos.

Disponible en
API y webhooks: planes Equipo, Agencia y Empresa. Servidor MCP: [planes por confirmar].
Claves
De producción y de pruebas, con permisos propios; solo se guarda una huella, no el valor.
Eventos de webhook
Los 13 eventos documentados se emiten hoy, entre ellos banner.generated, generation.failed, review.approved y export.ready.
Firma
Standard Webhooks: encabezados webhook-id, webhook-timestamp y webhook-signature (HMAC SHA-256, con tolerancia de 5 minutos) en cada aviso.

Funciones relacionadas

ExportarPide el export desde tu código.Ver SeguridadClaves, permisos y registro de cada acción.Ver Equipo y rolesQuién puede crear claves y webhooks.Ver

Aprende a usarlo paso a paso

Crear un banner con la APITutorialRecibir avisos con webhooksTutorial

Ejemplos de banners con esta función

Nébula · finanzas
Marejada · viajes
Pulso · deporte

Preguntas sobre api y webhooks

¿En qué planes está la API?

En Equipo ($99 al mes), Agencia ($299 al mes) y Empresa (desde $1.500 al mes). Starter no incluye API ni webhooks.

¿Gasto créditos al probar?

No con las claves de pruebas: devuelven siempre un banner de muestra, sin IA ni créditos. Las claves de producción usan los mismos créditos que la app.

¿Qué pasa si reintento un pedido?

Con el encabezado Idempotency-Key, repetir el mismo pedido devuelve el resultado anterior en lugar de cobrar otra vez.

¿Cómo sé que un webhook es de BannerMotion?

Cada aviso lleva las cabeceras webhook-id, webhook-timestamp y webhook-signature del estándar Standard Webhooks: una firma HMAC SHA-256 que verificas con el secreto de tu webhook. Los SDK traen la verificación lista.

¿Hay SDKs?

Hay clientes de TypeScript y Python, todavía sin publicar [fecha por confirmar]; se piden a soporte@bannermotion.com. Con cualquier otro lenguaje se usa un cliente generado desde la especificación OpenAPI 3.1.

¿Puedo conectar Claude u otro asistente de IA?

Sí: BannerMotion es un servidor MCP. Claude, Cursor o ChatGPT generan, corrigen, previsualizan y exportan con los permisos y créditos de tu workspace.

Conecta BannerMotion a tu plataforma.

Pruébalo con una campaña real.

Crear mi primera campañaHablar con ventas