Cómo usar una API de diseño
Una API de diseño deja que el software pida un gráfico como lo haría una persona en el editor. Sirve para posts automáticos, mocks y herramientas internas.
Para qué sirve una API de diseño
Las personas diseñan un post. El software necesita cincuenta PNG de marca cuando se actualiza el catálogo. Una API REST de diseño es el motor del editor con una puerta: envías un prompt, una plantilla o un plan, y vuelve un asset renderizado.
No sustituye el criterio. Sigues fijando kits de marca, tamaños (Instagram 4:5, stories 9:16, 16:9, A4/Carta) y límites. La API repite el trabajo sin abrir un portátil.
Autentica con una clave Bearer
Las claves de Amadezing se ven como amz_ y van en el header `Authorization: Bearer`. Trátalas como contraseñas: por entorno, rotables, nunca en un repo frontend público.
El playground está en todos los planes para ver peticiones y respuestas antes de cablear producción. Free, Starter y Pro siguen gastando créditos cuando corre la generación.
Una primera integración práctica
Empieza con un tamaño y una plantilla que ya te guste en el editor. Automatizar un mal layout solo hace malos layouts más rápido.
Registra el id del job. Los renders no siempre son instantáneos; haz poll o webhook según la docs del playground en lugar de bloquear un clic de usuario treinta segundos.
- Crea una clave en la cuenta y gárdala en el servidor.
- Abre el playground y lanza una petición de ejemplo al design-engine.
- Copia la llamada a tu backend con el header Bearer amz_.
- Pasa el contexto de marca (colores, fuentes, logos) como lo haría el kit del editor.
- Guarda el PNG devuelto (o colócalo luego en un lienzo) y, si quieres, publica/programa con tu flujo habitual.
Usa el playground antes de producción
El playground es donde aprendes la forma del payload, los errores y el coste en créditos. Es la misma API que llamará tu app. Saltártelo es cómo los equipos meten una clave en un bundle de Next.js cliente.
Deja un editor humano en el loop de la primera campaña. Remixea en el lienzo mobile-first y bloquea la plantilla que la API debe clonar.
Créditos, planes y honestidad
La generación de imagen (FLUX), los renders extra y los lotes grandes cuestan créditos. Presupuesta como presupuestas anuncios. La API no inventa cómputo gratis ilimitado.
Sigues teniendo las herramientas manuales — texto, imágenes, formas, emoji, motion, quitar fondo — para lo que el modelo no debería decidir. Lo híbrido es el punto: API para volumen, editor para el post héroe.
- Nunca expongas claves amz_ en el navegador.
- Versiona tus plantillas; la API debería nombrar la revisión que usó.
- Falla de forma visible cuando se acaben los créditos en lugar de servir un PNG en blanco.
Hazlo con Amadezing
La API REST de diseño de Amadezing comparte el motor del editor social: plantillas, remix, kits de marca, multi-tamaño, carruseles, exportar PNG. Posicionada como alternativa a Canva/Figma para social, más una puerta para el software.
Diseña la primera pieza a mano y deja que el playground te muestre la petición que haría las siguientes cincuenta.
Crea el diseño en el editor de Amadezing.