Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

Generazione di immagini Flux

Istruzioni di configurazione e utilizzo per la generazione di immagini Flux

Flux è un potente strumento di generazione di immagini in grado di creare immagini di alta qualità a partire da descrizioni testuali. Supporta vari stili artistici e offre ampie opzioni di personalizzazione.

Istruzioni di configurazione

  1. Ottieni la tua chiave API da bfl.ml
  2. Imposta la variabile d'ambiente FLUX_API_KEY nel tuo file .env:
FLUX_API_KEY=your_api_key_here
  1. Riavvia LibreChat e aggiungi Flux all'elenco Tools di un agente.
DeploymentCommand
Dockerdocker compose down && docker compose up -d
LocaleArresta il server, quindi esegui nuovamente npm run backend

Funzionalità

Funzionalità Principali

  • Genera immagini di alta qualità da descrizioni testuali dettagliate
  • Supporto per molteplici stili artistici
  • Dimensioni immagine personalizzabili
  • Parametri di generazione regolabili
  • Molteplici opzioni di endpoint per diversi casi d'uso
  • Supporto per la generazione in batch (fino a 24 immagini)

Endpoint disponibili

  • /v1/flux-pro - Endpoint standard (predefinito)
  • /v1/flux-pro-1.1 - Versione migliorata
  • /v1/flux-dev - Versione di sviluppo
  • /v1/flux-pro-1.1-ultra - endpoint di qualità premium

Parametri

Lo strumento Flux supporta tre azioni principali:

  1. generate - Crea una nuova immagine da un prompt di testo
  2. generate_finetuned - Crea un'immagine utilizzando un modello ottimizzato (fine-tuned)
  3. list_finetunes - Elenca i modelli personalizzati disponibili per l'utente

Per l'azione generate:

• prompt – Descrizione testuale per l'immagine (obbligatorio) • width – Larghezza in pixel (multiplo di 32) • height – Altezza in pixel (multiplo di 32) • prompt_upsampling – Indica se eseguire l'upsampling sul prompt (predefinito: false) • steps – Numero di passaggi di diffusione (1-50, predefinito: 40) • seed – Seed opzionale per la riproducibilità • safety_tolerance – Livello di tolleranza per la moderazione (0-6, predefinito: 6) • endpoint – endpoint del modello da utilizzare:

  • /v1/flux-pro-1.1 (predefinito)
  • /v1/flux-pro
  • /v1/flux-dev
  • /v1/flux-pro-1.1-ultra • raw – Genera immagini meno elaborate (solo per l'endpoint ultra, predefinito: false)

Per l'azione generate_finetuned:

• Tutti i parametri da generate più:
• finetune_id – ID del modello sottoposto a fine-tuning (obbligatorio)
• finetune_strength – Intensità dell'effetto di fine-tuning (0.1-1.2, predefinito: 1.1)
• guidance – Scala di guida (predefinito: 2.5)
• aspect_ratio – Rapporto d'aspetto per i modelli ultra (predefinito: "16:9")
• endpoint – Deve essere uno tra:

  • /v1/flux-pro-finetuned (predefinito)
  • /v1/flux-pro-1.1-ultra-finetuned

Best Practices

Scrittura dei prompt

  1. Sii specifico e dettagliato nelle descrizioni
  2. Include elementi chiave:
    • Argomento
    • Stile e approccio artistico
    • Dettagli della composizione
    • Illuminazione e atmosfera
    • Preferenze colore
    • Specifiche tecniche

Suggerimenti per i migliori risultati

  • Scrivi i prompt in inglese
  • Bilancia la specificità con la libertà creativa
  • Evita concetti in conflitto
  • Concentrati sulle descrizioni visive
  • Considera i livelli di composizione (primo piano, piano intermedio, sfondo)

Dettagli tecnici

Elaborazione immagini

  • Le immagini vengono salvate e gestite automaticamente
  • Supporta il formato di output PNG
  • Include funzionalità di moderazione e sicurezza integrate
  • Generazione asincrona con monitoraggio dello stato

Funzionalità di integrazione

  • Integrazione perfetta con le interfacce di chat
  • Output formattato in Markdown
  • Gestione degli errori e logging integrati
  • Supporto per l'elaborazione in batch

Esempi di utilizzo

Ecco alcuni esempi di prompt che funzionano bene con Flux:

Un sereno paesaggio montano al tramonto, con cime innevate che si riflettono in un lago alpino cristallino. Una calda luce dorata illumina nuvole leggere, creando un'atmosfera suggestiva. Stile fotorealistico con colori ricchi e dettagli nitidi.

Un paesaggio urbano futuristico di notte, caratterizzato da grattacieli illuminati al neon e veicoli volanti. Stile cyberpunk con blu e viola profondi, accentuati da colori neon brillanti. Le strade bagnate dalla pioggia riflettono le luci della città, creando un'atmosfera suggestiva.

Gestione degli errori

Messaggi di errore comuni e soluzioni:

  • Problemi con la API key: Verifica che la tua API key sia impostata correttamente nelle variabili d'ambiente
  • Errori di generazione: Controlla la lunghezza del prompt e le linee guida sui contenuti
  • Errori di timeout: possono verificarsi durante un carico elevato del server, riprovare dopo una breve attesa

Limiti di frequenza e utilizzo

  • Il piano gratuito include generosi limiti di utilizzo
  • È possibile generare più immagini in una singola richiesta
  • Valuta l'utilizzo di un numero di step inferiore per generazioni più rapide durante i test

Com’è questa guida?