Autenticación
Claves bm_live_ y bm_test_, permisos y buenas prácticas para usar la API.
La API deja que tu sistema genere banners sin abrir la aplicación. Es JSON sobre HTTPS y todo cuelga de https://app.bannermotion.com/api/v1. Cada petición lleva una clave de API.
Nota.
https://app.bannermotion.com es la dirección que usan nuestros SDK y el plugin de Figma. [PLACEHOLDER: confirmar el dominio definitivo de la API]Claves de API
En el menú lateral entra en Integraciones y API y pulsa Crear clave de API (solo el Propietario y las personas Admin). Ponle un nombre, elige el entorno y los permisos, y envía la clave en cada petición:
Authorization: Bearer bm_live_<tu-clave>EntornoQué hace
bm_live_… (Producción)Genera de verdad y gasta créditos según el modelo y lo que pidas: un concepto de 1 tamaño y 1 idioma cuesta
10 créditos con Sonnet 5.5, y sube con los tamaños y los idiomas de la petición.bm_test_… (Pruebas)No gasta créditos ni usa la IA ni escribe nada: devuelve siempre el mismo concepto de muestra para el mismo pedido. Sirve para probar tu integración. No funciona con el servidor MCP.
Permisos
Al crear la clave eliges qué puede hacer; los nombres entre paréntesis son los de la aplicación. Sin el permiso, la API responde 403. Cualquier permiso incluye leer.
PermisoPermite
generate(Generar banners) Crear conceptos (
POST /api/v1/banners), corregirlos, agregar tamaños e idiomas y archivar campañas. Incluye leer.read(Leer banners y estados) Consultar conceptos, trabajos, campañas y la biblioteca, y estimar créditos.
export(Exportar paquetes) Crear, consultar y descargar exportaciones (
/api/v1/exports). Incluye leer.assets(Gestionar la biblioteca) Subir y quitar archivos de la biblioteca (
POST y DELETE en /api/v1/assets). Incluye leer.Atención. El valor de la clave solo se muestra al crearla. Si se pierde, revócala y crea otra: una clave revocada responde
401. Úsala solo desde tu servidor, nunca en código que corre en el navegador de tus visitantes.Nota. La API acepta la clave solo en
Authorization: Bearer, nunca cookies, y responde con CORS abierto (Access-Control-Allow-Origin: *) para que pueda llamarla la interfaz de un plugin. Eso no cambia la regla anterior: la clave no va en código público.Nota. Si el correo del Propietario todavía no está verificado, lo que gasta créditos responde
403 con el código email_unverified.Nota. La API está disponible en los planes Equipo, Agencia y Empresa.
Errores y límitesEl formato de los errores, cada código de estado y el límite de peticiones por minuto.Crear un bannerCrea un concepto en todos los tamaños e idiomas que pidas. Responde 202 con un trabajo; consulta su estado o espera el webhook.SDK y OpenAPIClientes de TypeScript y Python, la especificación OpenAPI 3.1 y el llms.txt de la API.
¿Te sirvió esta página?