Modo IA

Você escreve uma frase, o motor devolve um QrConfig completo e o renderiza. O mesmo processo de validação se aplica; o que muda é quem escolhe as formas e as cores.

Entradas

Campo	Obrigatório	Observações
URL / conteúdo	sim	O que o QR vai codificar. A IA nunca inventa isso.
Prompt	sim	Linguagem natural. Mencione a marca, o clima, os materiais e as referências.
URL do logo	não	O motor baixa o logo, insere-o no centro e libera automaticamente os módulos que ficam embaixo.
Texto da faixa central	não	Um texto curto. Força o ECC H e uma cor de faixa contrastante.
Texto do CTA	não	Legenda abaixo do QR.
Predefinição de estilo	não	`luxury`, `minimal`, `artistic`, `corporate`, `tech`, `playful`, `nature`, `balanced`. Orienta o prompt.
Criatividade	não	`0.0–1.0`. Mais baixo = mais perto dos padrões seguros; mais alto = escolhas mais ousadas.

O que a IA controla

Forma dos módulos (quadrado / círculo / losango / hexágono / cruz / estrela / folha / ponto / pontiagudo / gota / …)
Olhos dos marcadores (formas externa e interna, cores)
Paleta (cor sólida, degradê linear, degradê radial, várias paradas)
Direção e ângulo do degradê
Forma do QR (quadrada / arredondada / circular)
Efeitos (sombra, brilho, relevo, ruído — dentro de faixas seguras)

O que a IA nunca muda

O conteúdo codificado (a sua URL continua sendo a sua URL).
O nível de ECC quando strictScannability está ativado (mantido em H se houver logo ou texto central).
O processo de validação. Toda saída passa pelas mesmas verificações.

Cadeia de provedores de reserva

O endpoint do servidor (/api/qr/ai/generate/server) tenta os provedores nesta ordem:

Groq (GPT-OSS 120B) — plano gratuito, o mais rápido
Groq (GPT-OSS 20B) — cota gratuita separada
OpenAI GPT-4.1-mini — reserva paga
Google Gemini Flash — último recurso

Um 429 em um provedor não derruba a requisição — o próximo da cadeia responde.

Exemplo

Prompt: "marca de relógios de luxo, fundo marfim, folha de ouro art déco, chevrons geométricos"

Configuração de saída (trecho):

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

Quer ver isso renderizado? É o card Art déco dourado na vitrine de IA da página inicial.