Modo IA

Escribes una frase y el motor devuelve un QrConfig completo y lo renderiza. Se aplica el mismo proceso de validación; lo que cambia es quién elige las formas y los colores.

Entradas

Campo	Obligatorio	Notas
URL / contenido	sí	Lo que codificará el QR. La IA nunca se lo inventa.
Prompt	sí	En lenguaje natural. Menciona la marca, el ambiente, los materiales y tus referencias.
URL del logo	no	El motor lo descarga, lo inserta en el centro y libera automáticamente los módulos que quedan debajo.
Texto de la banda central	no	Una cadena corta. Fuerza el ECC H y un color de banda que contraste.
Texto de CTA	no	Leyenda debajo del QR.
Preajuste de estilo	no	`luxury`, `minimal`, `artistic`, `corporate`, `tech`, `playful`, `nature`, `balanced`. Orienta el prompt.
Creatividad	no	`0.0–1.0`. Más bajo = más cerca de los valores seguros; más alto = elecciones más atrevidas.

Qué controla la IA

Forma de los módulos (cuadrado / círculo / rombo / hexágono / cruz / estrella / hoja / punto / en punta / gota / …)
Ojos de los marcadores (formas exterior e interior, colores)
Paleta (color sólido, degradado lineal, degradado radial, varias paradas)
Dirección y ángulo del degradado
Forma del QR (cuadrada / redondeada / circular)
Efectos (sombra, resplandor, relieve, ruido, siempre dentro de rangos seguros)

Qué nunca cambia la IA

El contenido codificado (tu URL sigue siendo tu URL).
El nivel de ECC cuando strictScannability está activado (se mantiene en H si hay logo o texto central).
El proceso de validación. Todas las salidas pasan las mismas comprobaciones.

Cadena de proveedores de respaldo

El endpoint del servidor (/api/qr/ai/generate/server) prueba los proveedores en este orden:

Groq (GPT-OSS 120B): plan gratuito, el más rápido
Groq (GPT-OSS 20B): cuota gratuita independiente
OpenAI GPT-4.1-mini: respaldo de pago
Google Gemini Flash: último recurso

Un 429 en un proveedor no rompe la petición: responde el siguiente de la cadena.

Ejemplo

Prompt: «marca de relojes de lujo, fondo marfil, pan de oro art déco, chevrones geométricos»

Configuración de salida (extracto):

{
  "backgroundColor": "#f5ecd2",
  "primaryColor": "#5e4524",
  "foregroundStyle": "solid",
  "moduleShape": "diamond",
  "moduleScale": 0.78,
  "finderOuterShape": "octagon",
  "finderInnerShape": "diamond",
  "finderOuterColor": "#3d2a14",
  "finderInnerColor": "#a98349",
  "eccLevel": "H"
}

¿Quieres verlo renderizado? Es la tarjeta Art deco gold del escaparate de IA de la portada.