Documentazione Experience Platform Tutorial tecnico su Adobe

API per modelli personalizzati Firefly 1.1.4

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

Principiante
Sviluppatore

1.1.4.1 Cosa sono i modelli personalizzati di Firefly?

Con i modelli personalizzati di Firefly, puoi generare varianti di immagine allineate al tuo marchio utilizzando la funzione Testo in immagine. Addestrando questi modelli con le tue immagini, puoi generare contenuti che riflettono l’identità del tuo marchio.
Trasforma il tuo stile o il tuo oggetto per esplorare nuove idee, visualizzare ambienti diversi, generare contenuti innovativi e adattare i contenuti a segmenti specifici.

Con i modelli personalizzati di Firefly puoi…

Creare idee e concetti sul marchio
Produrre temi di carattere con stili coerenti
Creare stili di brand coerenti per espandere rapidamente le campagne

Per ottenere questo risultato, i modelli personalizzati di Firefly supportano:

Modelli di oggetto personalizzati
Modelli di stile personalizzati

Modelli di oggetto personalizzati

Quando si addestrano modelli personalizzati su un argomento specifico, che si tratti di oggetti o di caratteri, l’obiettivo è quello di identificare le caratteristiche essenziali del soggetto e aiutare il modello a replicarle in vari contesti e posizioni.

Durante la formazione di un modello di soggetto, cerca le immagini con le seguenti caratteristiche:

Coerenza oggetto: fornire immagini della stessa marca e dello stesso modello del soggetto, assicurandosi che il soggetto non sia molto diverso tra le immagini. Evitare di mescolare più colori e garantire un tema o un motivo comune tra le immagini. Tuttavia, il soggetto può variare tra scene, pose, vestiti e sfondo.
Focus sull’oggetto: utilizza immagini del soggetto in chiaro focus senza distrazioni inutili. Tenere il soggetto vicino al centro dell'immagine e assicurarsi che occupi almeno il 25% dell'area dell'immagine.
Contesto ambientale: fornire immagini del soggetto in diversi punti di vista e contesti, visualizzandole in varie condizioni di illuminazione. Anche se è possibile utilizzare immagini con sfondi bianchi o trasparenti, è meglio utilizzare un mix con ambienti più complessi.
Evita altri oggetti: evita elementi di grandi dimensioni sullo sfondo o associati al carattere. Qualsiasi elemento di grandi dimensioni mostrato nelle immagini viene memorizzato dal modello e viene visualizzato nelle immagini generate, in modo simile allo stesso elemento nel set di dati di apprendimento.

Modelli di stile personalizzati

I modelli personalizzati addestrati su uno stile identificano l’aspetto delle risorse per generare immagini simili quando richiesto.

Per addestrare un modello di stile efficace:

Estetica simile: Includi immagini che mostrano varie scene e oggetti mantenendo lo stesso aspetto.
Usa varie immagini: usa quante più immagini possibili per evitare che il modello si concentri troppo su oggetti o soggetti indesiderati.
Evita frasi fisse: un modello fisso ha un peso maggiore rispetto ad altre frasi. Ad esempio, se ogni didascalia contiene "Lo sfondo è di colore nero puro" o "stili di fumetto graziosi", il modello dipenderà da questa frase e qualsiasi richiesta di test senza di essa non genererà i risultati desiderati.

1.1.4.2 Configura il modello personalizzato

Vai a https://firefly.adobe.com/. Fare clic su Modelli personalizzati.

Modelli personalizzati Firefly {modal="regular"}

È possibile che questo messaggio venga visualizzato. In caso contrario, fare clic su Accetto per continuare.

Modelli personalizzati Firefly {modal="regular"}

Dovresti vedere questo. Fai clic su Addestra un modello.

Modelli personalizzati Firefly {modal="regular"}

Configura i campi seguenti:

Nome: utilizzare --aepUserLdap-- - Citi Signal Router Model
Modalità di formazione: seleziona Oggetto (anteprima tecnica)
Concetto: immettere router
Salva in: apri l'elenco a discesa e fai clic su + Crea nuovo progetto

Modelli personalizzati Firefly {modal="regular"}

Assegnare un nome al nuovo progetto: --aepUserLdap-- - Custom Models. Fai clic su Crea.

Modelli personalizzati Firefly {modal="regular"}

Dovresti vedere questo. Fai clic su Continua.

Modelli personalizzati Firefly {modal="regular"}

Ora devi fornire le immagini di riferimento per il modello personalizzato da addestrare. Fai clic su Seleziona immagini dal computer.

Modelli personalizzati Firefly {modal="regular"}

Scarica le immagini di riferimento qui. Decomprimi il file di download, che ti fornirà questo.

Modelli personalizzati Firefly {modal="regular"}

Passare alla cartella contenente i file dell'immagine di download. Selezionali tutti e fai clic su Apri.

Modelli personalizzati Firefly {modal="regular"}

Si vedrà che le immagini vengono caricate.

Modelli personalizzati Firefly {modal="regular"}

Dopo alcuni minuti, le immagini vengono caricate correttamente. È possibile che alcune immagini presentino un errore, dovuto al fatto che la didascalia dell’immagine non è stata generata o non è sufficientemente lunga. Esaminate ogni immagine con un errore e immettete una didascalia che soddisfi i requisiti e descriva l'immagine.

Modelli personalizzati Firefly {modal="regular"}

Una volta che tutte le immagini hanno sottotitoli che soddisfano i requisiti, è comunque necessario fornire un prompt di esempio. Immettere un prompt che utilizzi la parola "router". Dopo aver fatto questo, puoi iniziare ad addestrare il tuo modello. Fai clic su Addestra.

Modelli personalizzati Firefly {modal="regular"}

Poi vedrai questo. La formazione del modello può richiedere dai 20 ai 30 minuti o più.

Modelli personalizzati Firefly {modal="regular"}

Dopo 20-30 minuti, il modello è ora addestrato e può essere pubblicato. Fai clic su Pubblica.

Modelli personalizzati Firefly {modal="regular"}

Fai di nuovo clic su Pubblica.

Modelli personalizzati Firefly {modal="regular"}

Chiudere la finestra a comparsa Condividi modello personalizzato.

Modelli personalizzati Firefly {modal="regular"}

1.1.4.3 Utilizza il tuo modello personalizzato nell'interfaccia utente

Vai a https://firefly.adobe.com/cme/train. Fai clic sul modello personalizzato per aprirlo.

Modelli personalizzati Firefly {modal="regular"}

Fare clic su Anteprima e prova.

Modelli personalizzati Firefly {modal="regular"}

Viene quindi visualizzato il prompt di esempio immesso prima dell'esecuzione.

Modelli personalizzati Firefly {modal="regular"}

1.1.4.4 Abilita il tuo modello personalizzato per l'API dei modelli personalizzati di Firefly Services

Una volta che il modello personalizzato è stato addestrato, può essere utilizzato anche tramite l’API. Nell’esercizio 1.1.1 hai già configurato il progetto Adobe I/O per l’interazione con Firefly Services tramite l’API.

Vai a https://firefly.adobe.com/cme/train. Fai clic sul modello personalizzato per aprirlo.

Modelli personalizzati Firefly {modal="regular"}

Fare clic sui tre punti … e quindi su Condividi.

Modelli personalizzati Firefly {modal="regular"}

Per accedere a un modello personalizzato di Firefly, il modello personalizzato deve essere condiviso nella e-mail account tecnico del progetto Adobe I/O.

Per recuperare l'e-mail account tecnico, vai a https://developer.adobe.com/console/projects. Fare clic per aprire il progetto, denominato --aepUserLdap-- One Adobe tutorial.

Modelli personalizzati Firefly {modal="regular"}

Fare clic su Server-to-Server OAuth.

Modelli personalizzati Firefly {modal="regular"}

Fai clic per copiare l'e-mail account tecnico.

Modelli personalizzati Firefly {modal="regular"}

Incolla la e-mail account tecnico e fai clic su Invita a modificare.

Modelli personalizzati Firefly {modal="regular"}

L'e-mail account tecnico dovrebbe ora essere in grado di accedere al modello personalizzato.

Modelli personalizzati Firefly {modal="regular"}

1.1.4.5 interagisce con l'API dei modelli personalizzati di Firefly Services

Nell'esercizio 1.1.1 Guida introduttiva a Firefly Services, hai scaricato il file postman-ff.zip sul desktop locale e quindi hai importato la raccolta in Postman.

Apri Postman e vai alla cartella FF - Modelli personalizzati API.

Modelli personalizzati Firefly {modal="regular"}

Apri la richiesta 1. FF - getCustomModels e fare clic su Invia.

Modelli personalizzati Firefly {modal="regular"}

Nella risposta dovrebbe essere visualizzato il modello personalizzato creato in precedenza, denominato --aepUserLdap-- - Citi Signal Router Model. Il campo assetId è l'identificatore univoco del modello personalizzato a cui verrà fatto riferimento nella richiesta successiva.

Modelli personalizzati Firefly {modal="regular"}

Apri la richiesta 2. Genera immagini asincrone. In questo esempio, richiederai la generazione di 2 varianti in base al modello personalizzato. Puoi aggiornare il prompt che in questo caso è a white router on a volcano in Africa.

Fai clic su Invia.

Modelli personalizzati Firefly {modal="regular"}

La risposta contiene un campo jobId. Il processo per generare queste 2 immagini è ora in esecuzione e puoi controllarne lo stato utilizzando la richiesta successiva.

Modelli personalizzati Firefly {modal="regular"}

Apri la richiesta 3. Ottieni lo stato CM e fai clic su Invia. A questo punto lo stato è impostato su In esecuzione.

Modelli personalizzati Firefly {modal="regular"}

Dopo alcuni minuti, fare di nuovo clic su Invia per la richiesta 3. Ottieni stato CM. Dovresti vedere che lo stato è cambiato in completato e che nell'output dovrebbero essere presenti due URL di immagine. Fare clic per aprire entrambi i file.

Modelli personalizzati Firefly {modal="regular"}