1.1.1 Guida introduttiva a Firefly Services

Firefly Services include API Firefly, API Lightroom, API Photoshop, API InDesign e API di assegnazione tag contenuto.

Queste suite di API combinano la potenza degli strumenti creativi di Adobe come Photoshop e Lightroom con funzioni AI/ML all’avanguardia come l’assegnazione di tag ai contenuti, il riempimento generativo, il passaggio da testo a immagine e altro ancora.

Con Firefly Services, non si tratta solo di creare, ma di automatizzare, scalare la produzione dei contenuti e sfruttare le più recenti tecnologie AI/ML per sovrascrivere i flussi di lavoro.

In questo esercizio imparerai a utilizzare Postman e Adobe I/O per lavorare con le varie API di Adobe Firefly Services.

Questo esercizio si concentra specificamente sulle API di Firefly, ad esempio:

1.1.1.1 Prerequisiti

Prima di continuare con questo esercizio, devi aver completato la configurazione di il tuo progetto Adobe I/O e devi anche aver configurato un'applicazione per interagire con le API, ad esempio Postman o PostBuster.

Nozioni di base sull'API 1.1.1.2

Esistono diversi tipi di richieste API:

Quando lavori con le API, noterai anche che i codici di risposta vengono restituiti dai vari endpoint API.

Sono disponibili 5 diverse categorie di risposte:

Di seguito è riportato un esempio di codici di risposta comuni:

1.1.1.3 Esplora firefly.adobe.com - fase 1

Cominciamo ad esplorare Adobe Firefly Services. A scopo di esplorazione, inizierai con un esempio di generazione di immagini CitiSignal. Il team di progettazione di CitiSignal desidera generare una versione al neon del marchio CitiSignal. Vorrebbe usare Adobe Firefly Services per farlo.

La prima cosa che serve per ottenere questo risultato è una versione in bianco e nero del marchio CitiSignal, qualcosa di simile al seguente:

1.1.1.3.1 Crea l'immagine di riferimento della composizione

Puoi utilizzare questa immagine di esempio oppure creare un testo personalizzato da sperimentare. Per creare un file di immagine personalizzato, segui i passaggi seguenti in Adobe Illustrator. Se si desidera utilizzare l'immagine predefinita, saltare la sezione seguente e passare al passaggio 1.1.1.3.2 Generare direttamente l'immagine.

Apri Adobe Illustrator. Fare clic su Nuovo file.

Selezionare Web-Large 1920 x 1080px. Fai clic su Crea.

Dovresti avere questo. Fai clic sull'icona di testo T.

Dovresti avere questo.

Modificare il tipo di carattere in un tipo di carattere scelto, in questo caso il tipo di carattere è Adobe Clean Bold.

Impostare la dimensione del carattere come preferita, in questo caso 250 pt.

Dovresti avere questo.

Modificare il testo come desiderato, in questo caso CitiSignal.

Centra il testo nel file.

Vai a File > Esporta > Salva per Web (versione precedente)

Dovresti avere questo. Fai clic su Salva.

Assegna un nome al file e salvalo sul desktop. Fai clic su Salva.

1.1.1.3.2 Genera l'immagine

Vai a https://firefly.adobe.com. Fai clic sull'icona profilo e accertati di aver effettuato l'accesso all'account Account a destra, che dovrebbe essere --aepImsOrgName--. Se necessario, fare clic su Cambia profilo per passare a tale account.

Immettere il prompt neon light lettering on a brick wall of a night club. Fai clic su Genera.

Dovresti avere qualcosa di simile a questo. Queste immagini non sono ancora utili. In Composizione, fare clic su Carica immagine.

Seleziona l'immagine creata in precedenza, in questo caso CitiSignal.jpg. Fare clic su Apri e quindi su Genera.

Dovresti avere qualcosa di simile a questo. L'applicazione del riferimento Composizione non è ancora ottimale. Per modificare questa impostazione, impostare il cursore Forza sul valore massimo. Fai di nuovo clic su Genera.

Sono ora disponibili diverse immagini che mostrano una versione neon del nome del marchio CitiSignal, che puoi utilizzare per eseguire ulteriori iterazioni.

Ora hai imparato a utilizzare Firefly per risolvere un problema di progettazione in pochi minuti.

1.1.1.4 Esplora firefly.adobe.com - fase 2

Vai a https://firefly.adobe.com/generate/image. Dovresti vedere questo. Fare clic sull'elenco a discesa Modello. Sono disponibili 3 versioni di Adobe Firefly Services:

Fare clic per selezionare Firefly Image 3 per questo esercizio.

Immettere il prompt Horses in a field e fare clic su Genera.

Dovresti vedere qualcosa di simile a questo.

Apri i Strumenti per sviluppatori nel browser.

Dovresti vedere questo. Passare alla scheda Rete. Quindi, fai di nuovo clic su Genera.

Immettere il termine di ricerca generate-async. Dovresti quindi visualizzare una richiesta denominata generate-async. Selezionala e passa a Payload dove visualizzerai i dettagli della richiesta.

La richiesta che vedi qui è la richiesta inviata al backend lato server di Firefly Services. Contiene diversi parametri importanti:

Dai un’occhiata di nuovo all’interfaccia utente. Modificare le proporzioni in Widescreen (16:9).

Scorri verso il basso fino a Effetti, passa a Temi e seleziona un effetto come Art deco.

Assicurati che Strumenti per sviluppatori sia ancora aperto nel browser. Quindi, fare clic su Genera ed esaminare la richiesta di rete inviata.

Quando analizzi i dettagli della richiesta di rete, visualizzerai quanto segue:

Per il prossimo esercizio, dovrai utilizzare uno dei numeri seed. Annotare un numero di seed desiderato.

Nel prossimo esercizio, eseguirai operazioni simili con Firefly Services, ma in seguito utilizzerai l’API invece dell’interfaccia utente. In questo esempio, il numero di seed è 142194 per la prima immagine, con 2 cavalli che si guardano l'un l'altro con le teste rivolte l'uno verso l'altro.

1.1.1.5 Adobe I/O - access_token

Nella raccolta Adobe IO - OAuth, selezionare la richiesta denominata POST - Ottieni token di accesso e selezionare Invia. La risposta deve contenere un nuovo access_token.

API Firefly Services 1.1.1.6, immagine testo 2, immagine 3

Ora che disponi di un access_token valido e aggiornato, puoi inviare la tua prima richiesta alle API di Firefly Services.

La richiesta che utilizzerai è una richiesta asincrona, che ti fornisce una risposta contenente l'URL del processo inviato, il che significa che dovrai utilizzare una seconda richiesta per controllare lo stato del processo e accedere all'immagine generata.

Selezionare la richiesta denominata POST - Firefly - T2I V3 asincrona dalla raccolta FF - Firefly Services Tech Insiders. Vai a Intestazioni e verifica le combinazioni chiave/valore.

Entrambi i valori in questa richiesta fanno riferimento a variabili di ambiente definite in precedenza. {{API_KEY}} fa riferimento al campo ID client del progetto Adobe I/O. Come parte della sezione Guida introduttiva di questa esercitazione, l'hai configurata in Postman.

Il valore del campo Autorizzazione è un po' speciale: Bearer {{ACCESS_TOKEN}}. Contiene un riferimento al token di accesso generato nel passaggio precedente. Quando hai ricevuto il Token di accesso utilizzando la richiesta POST - Ottieni token di accesso nella raccolta Adobe IO - OAuth, è stato eseguito uno script in Postman in cui il campo access_token è archiviato come variabile di ambiente a cui viene ora fatto riferimento nella richiesta POST - Firefly - T2I V3 asincrono. Notare l'aggiunta specifica della parola Bearer e uno spazio prima di {{ACCESS_TOKEN}}. La parola bearer fa distinzione tra maiuscole e minuscole ed è necessario specificare lo spazio. Se l'operazione non viene eseguita correttamente, Adobe I/O restituirà un errore 401 Non autorizzato poiché non sarà in grado di elaborare correttamente il Token di accesso.

Quindi, vai al Corpo e verifica il prompt. Fai clic su Invia.

Riceverai quindi una risposta immediata. Questa risposta non contiene gli URL immagine dell’immagine generata, ma un URL del rapporto sullo stato del processo avviato e un altro URL che consente di annullare il processo in esecuzione.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

Avresti dovuto ricevere una risposta simile. Panoramica del processo eseguito. È possibile visualizzare il campo url, che contiene l'immagine generata. Copia (o fai clic) sull’URL dell’immagine dalla risposta e aprilo nel browser web per visualizzarla.

Dovresti vedere una bella immagine che rappresenta horses in a field.

Nel Corpo della richiesta POST - Firefly - T2I V3 asincrono, aggiungere quanto segue nel campo "promptBiasingLocaleCode": "en-US" e sostituire la variabile XXX con uno dei numeri di seed utilizzati in modo casuale dall'interfaccia utente di Firefly Services. In questo esempio, il numero seed è 142194.

,
  "seeds": [
    XXX
  ]

Fai clic su Invia. Riceverai quindi di nuovo una risposta con un collegamento alla relazione sullo stato del processo appena inviato.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

Dovresti quindi visualizzare una nuova immagine con lievi differenze, in base al seed utilizzato. Il seme 142194 aveva 2 cavalli che si guardavano l'un l'altro con la testa rivolta verso l'altro.

Quindi, in Body della richiesta POST - Firefly - T2I V3 asincrono, incolla l'oggetto styles seguente sotto l'oggetto seed. Lo stile dell'immagine generata verrà modificato in art_deco.

,
  "contentClass": "art",
  "styles": {
    "presets": [
      "art_deco"
    ],
    "strength": 50
  }

Dovresti avere questo. Fai clic su Invia. Riceverai quindi di nuovo una risposta con un collegamento alla relazione sullo stato del processo appena inviato.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

L'immagine è cambiata un po'. Quando applicate i predefiniti di stile, l'immagine di partenza non viene più applicata come prima. Nel complesso, con l’intelligenza artificiale generativa, è molto difficile garantire che la stessa combinazione di parametri inpunt porti alla generazione della stessa immagine.

Rimuovi il codice per l'oggetto seed da Body della richiesta POST - Firefly - T2I V3 asincrona. Fai clic su Invia, quindi fai clic sull'URL dell'immagine che ottieni dalla risposta. Riceverai quindi di nuovo una risposta con un collegamento alla relazione sullo stato del processo appena inviato.

,
  "seeds": [
    XXX
  ]

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

L'immagine è cambiata di nuovo un po'.

API Firefly Services 1.1.1.7, Gen Expand

Seleziona la richiesta denominata POST - Firefly - Gen Expand async dalla raccolta FF - Firefly Services Tech Insiders e passa a Body della richiesta.

Riceverai quindi di nuovo una risposta con un collegamento alla relazione sullo stato del processo appena inviato.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

Ora l'immagine generata nell'esercizio precedente è stata espansa alla risoluzione di 3999x3999.

Genera una nuova immagine utilizzando la richiesta Firefly - T2I V3 asincrona.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

Dovresti vedere un’immagine simile.

Seleziona la richiesta denominata POST - Firefly - Gen Expand async dalla raccolta FF - Firefly Services Tech Insiders e passa a Body della richiesta.

Quando modificate l'allineamento del posizionamento, anche l'output sarà leggermente diverso. In questo esempio, il posizionamento viene modificato in left, bottom. Fai clic su Invia. Riceverai quindi di nuovo una risposta con un collegamento alla relazione sullo stato del processo appena inviato.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

Dovreste quindi vedere che l'immagine originale viene utilizzata in un posizionamento diverso, che influenza l'intera immagine.

API Firefly Services 1.1.1.8, immagine Text 2, immagine Image 4 e immagine 4 Ultra

Con la recente versione di Firefly Image Model 4, sono stati resi disponibili diversi miglioramenti:

Firefly Image Model 4 offre immagini eccezionali di persone, animali e scene dettagliate. È possibile utilizzare Image Model 4 Ultra per generare immagini con interazioni umane iperrealistiche, elementi architettonici e paesaggi complessi​

1.1.1.8.1 image4_standard

Seleziona la richiesta denominata POST - Firefly - T2I V4 dalla raccolta FF - Firefly Services Tech Insiders e passa alle Intestazioni della richiesta.

Noterai che l'URL della richiesta è diverso dalla richiesta Firefly Services API, Text 2 Image, Image 3, che era https://firefly-api.adobe.io/v3/images/generate. Questo URL punta a https://firefly-api.adobe.io/v3/images/generate-async. L'aggiunta di -async nell'URL indica che si sta utilizzando l'endpoint asincrono.

Nelle variabili Header noterai una nuova variabile denominata x-model-version. Questa è un’intestazione obbligatoria quando si interagisce con Firefly Image 4 e Image 4 Ultra. Per utilizzare Firefly Image 4 o Image 4 Ultra durante la generazione delle immagini, il valore dell'intestazione deve essere impostato su image4_standard o image4_ultra. In questo esempio utilizzerai image4_standard.

Se non si imposta x-model-version su image4_standard o image4_ultra, per impostazione predefinita Firefly Services utilizzerà image3 al momento.

Vai al Corpo della richiesta. Dovresti notare che nel corpo sono richieste 4 varianti di immagini. Il prompt è invariato rispetto a prima e richiede la generazione di cavalli in un campo. Fai clic su Invia

Riceverai quindi una risposta immediata. Questa risposta non contiene gli URL immagine dell’immagine generata, ma un URL del rapporto sullo stato del processo avviato e un altro URL che consente di annullare il processo in esecuzione.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia.

Viene quindi visualizzato il rapporto sullo stato del processo di generazione delle immagini appena avviato. Verificare il campo status, poiché potrebbe essere impostato su running, il che significa che il processo non è ancora stato completato. In questo esempio, lo stato del processo è impostato su completato, il che significa che le immagini richieste sono state generate.

Scorri verso il basso nella risposta per vedere un totale di 4 varianti di immagine restituite da Adobe Firefly Services. Fai clic sull’URL di una delle immagini (o copialo) e aprilo nel browser.

Dovresti quindi vedere un'immagine iperrealistica di cavalli in un campo.

1.1.1.8.2 image4_ultra

Torna alla richiesta denominata POST - Firefly - T2I V4 dalla raccolta FF - Firefly Services Tech Insiders e passa alle Intestazioni della richiesta.

Modificare la variabile x-model-version in image4_ultra. In questo esempio utilizzerai image4_ultra.

Vai al Corpo della richiesta. Nel corpo, modifica il numero di varianti di immagine in 1 come con Firefly Image 4 Ultra, è possibile generare solo 1 immagine alla volta. Il prompt è invariato rispetto a prima e richiede la generazione di cavalli in un campo. Fai clic su Invia

La risposta contiene nuovamente un URL del rapporto sullo stato del processo avviato e un altro URL che consente di annullare il processo in esecuzione.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia.

Viene quindi visualizzato il rapporto sullo stato del processo di generazione delle immagini appena avviato. Verificare il campo status, poiché potrebbe essere impostato su running, il che significa che il processo non è ancora stato completato. In questo esempio, lo stato del processo è impostato su completato, il che significa che le immagini richieste sono state generate.

Dovresti quindi vedere un'immagine iperrealistica di cavalli in un campo.

Prompt negativo

Nel caso in cui si desideri richiedere a Firefly di non includere nell'immagine qualcosa che verrà generato, è possibile includere il campo negativePrompt quando si utilizza l'API (questa opzione non è attualmente esposta all'interfaccia utente). Ad esempio, se non desideri includere fiori quando viene eseguito il prompt cavalli in un campo, puoi specificarlo nel Corpo della richiesta API:

"negativePrompt": "no flowers",

Vai alla richiesta POST - Firefly - T2I V4 dalla raccolta FF - Firefly Services Tech Insiders e passa al Body della richiesta. Incolla il testo precedente nel corpo della richiesta. Fai clic su Invia.

Dovresti vedere questo.

Per controllare la relazione sullo stato del processo in esecuzione, selezionare la richiesta denominata GET - Firefly - Ottieni relazione sullo stato dalla raccolta FF - Firefly Services Tech Insiders. Fare clic per aprirlo e quindi su Invia. Seleziona l’URL dell’immagine generata e aprilo nel browser.

Viene quindi visualizzata l'immagine generata, che non deve contenere fiori.

Passaggi successivi

Vai a Ottimizza il processo Firefly utilizzando Microsoft Azure e gli URL prefirmati

Torna a Panoramica di Adobe Firefly Services

Torna a Tutti i moduli