Generazione Immagini con AI - FLUX Integrato

✅ Sistema Attivo: FLUX-1.1-pro

Il sistema di generazione immagini ora usa FLUX-1.1-pro via Replicate, il modello più avanzato per food/beverage photography.

Funzionalità Implementate

1. Generazione Immagini

• Endpoint: /api/ai/generate-product-image-flux
• Modello: FLUX-1.1-pro (black-forest-labs)
• Qualità: 1024x1024 PNG, quality 100
• Prompt: Ottimizzato per product photography minimalista

2. Miglioramento Intelligente

• Endpoint: /api/ai/improve-product-image-flux
• Analisi: GPT-4 Vision valuta prima se serve migliorare
• Generazione: Solo se quality score < 7 o needs_improvement = true
• Risparmio: Evita generazioni inutili per immagini già ottime

Setup Richiesto

1. Ottieni token Replicate:

   • Vai su https://replicate.com/account/api-tokens 
   • Crea un nuovo token API
   • Copia il token (formato: r8_...)

2. Configura variabile ambiente: Aggiungi al file .env.local:

   REPLICATE_API_TOKEN=r8_your_token_here

3. Riavvia il server:

   npm run dev

Costi Operativi

• FLUX-1.1-pro: ~$0.04 per immagine
• GPT-4 Vision (analisi): ~$0.01 per immagine
• Totale: ~$0.05 per operazione
• Tempo: 15-30 secondi per immagine

Caratteristiche FLUX vs DALL-E

Workflow Utente

Genera Nuova Immagine

1. Utente clicca “Genera con AI”
2. Sistema invia richiesta a FLUX con prompt ottimizzato
3. FLUX genera immagine professionale
4. Immagine caricata su S3
5. Prodotto aggiornato automaticamente

Migliora Immagine Esistente

1. Utente clicca “Migliora con AI”
2. GPT-4 Vision analizza immagine corrente
3. Se score ≥ 7: “Immagine già ottimale” (nessun costo)
4. Se score < 7: FLUX genera versione migliorata
5. Immagine nuova sostituisce quella vecchia

Prompt Engineering

I prompt FLUX sono ottimizzati per:

• Minimalismo: Solo prodotto finale, no ingredienti
• Container appropriato: Glass/plate/bowl automatico
• Lighting professionale: Studio lighting, soft shadows
• Background pulito: White/transparent
• No elementi extra: No text, logos, watermarks

File Modificati

✅ src/app/api/ai/generate-product-image-flux/route.ts
✅ src/app/api/ai/improve-product-image-flux/route.ts
✅ src/components/ProductImageCard/ProductImageCard.tsx
✅ package.json (replicate@latest)
✅ .env.example

Fallback

Gli endpoint DALL-E 3 originali sono mantenuti per compatibilità:

• /api/ai/generate-product-image (DALL-E 3)
• /api/ai/improve-product-image (DALL-E 3 + GPT-4 Vision)

Debug

Se FLUX non funziona:

1. Verifica REPLICATE_API_TOKEN in .env.local
2. Controlla crediti Replicate account
3. Vedi logs console: [FLUX_GENERATE] / [FLUX_IMPROVE]
4. Sistema usa fallback automatico se token mancante

Best Practices

1. Descrizioni prodotto: Più dettagli = risultati migliori
2. Categorie precise: Es. “Amaro” vs generico “Bevanda”
3. Analisi prima: Usa “Migliora” per validare qualità
4. Storico immagini: Usa pulsante “Storico” per recuperare versioni precedenti
5. Test A/B: Genera 2-3 volte, scegli la migliore

Monitoraggio Costi

Per monitorare uso Replicate:

1. Dashboard: https://replicate.com/account 
2. Vedi “Usage” per costi mensili
3. Imposta billing alerts se necessario
4. 1000 immagini/mese ≈ $40

Troubleshooting

Errore: “Failed to generate image with FLUX”

Test della connessione:

1. Vai a: http://localhost:3000/api/ai/test-flux
2. Controlla la risposta JSON

Possibili cause:

1. Token non configurato:

   # Verifica che sia nel .env.local
   echo $REPLICATE_API_TOKEN

2. Token non valido:

   • Vai su https://replicate.com/account/api-tokens 
   • Verifica che il token sia attivo
   • Rigenera se necessario

3. Crediti insufficienti:

   • Controlla billing su https://replicate.com/account 
   • Aggiungi metodo di pagamento

4. Modello non disponibile:

   • Verifica su https://replicate.com/black-forest-labs/flux-1.1-pro 
   • Controlla status del modello

Logs da controllare:

# Nel terminale del server
[FLUX_GENERATE] Generating image with prompt: ...
[FLUX_GENERATE] Raw output: ...
[FLUX_GENERATE] Extracted image URL: ...

Formato output atteso:

• FLUX può restituire: string oppure string[]
• URL formato: https://replicate.delivery/...

Fallback a DALL-E 3

Se FLUX continua a dare problemi, modifica temporaneamente:

// In ProductImageCard.tsx
const response = await fetch("/api/ai/generate-product-image", {
  // Usa endpoint DALL-E invece di FLUX

Prossimi Miglioramenti

• Batch generation per prodotti multipli
• Style presets (minimal, artistic, commercial)
• Background removal automatico
• Upscaling 2K/4K opzionale
• Caching intelligente risultati