1.1.1 Erste Schritte mit Firefly Services

Firefly Services umfasst Firefly-APIs Lightroom-APIs Photoshop-, InDesign- und Content-Tagging-APIs.

Diese API-Suites kombinieren die Leistungsfähigkeit der Kreativ-Tools von Adobe wie Photoshop und Lightroom mit hochmodernen KI-/ML-Funktionen wie Inhalts-Tagging, generativer Füllung, Text-zu-Bild-Kombination und mehr.

Mit Firefly Services erstellen Sie nicht nur - Sie automatisieren, skalieren Ihre Inhaltserstellung und nutzen die neuesten KI/ML-Technologien, um Ihre Workflows zu beleben.

In dieser Übung erfahren Sie, wie Sie Postman und Adobe I/O verwenden, um mit den verschiedenen Adobe Firefly Services-APIs zu arbeiten.

Diese Übung konzentriert sich speziell auf die Firefly-APIs, z. B.:

Voraussetzungen für 1.1.1.1

Bevor Sie mit dieser Übung fortfahren, müssen Sie das Setup von Ihr Adobe I/O-Projekt abgeschlossen haben. Außerdem müssen Sie eine Anwendung für die Interaktion mit APIs konfiguriert haben, z. B. Postman oder PostBuster.

1.1.1.2 API-Grundlagen

Es gibt mehrere Arten von API-Anfragen:

Beim Arbeiten mit APIs werden Sie auch feststellen, dass von den verschiedenen API-Endpunkten Antwort-Codes zurückgegeben werden.

Es gibt 5 verschiedene Kategorien von Antworten, die Sie erwarten können:

Im Folgenden finden Sie ein Beispiel für häufig verwendete Antwort-Codes:

1.1.1.3 Erkunden Sie firefly.adobe.com - Schritt 1

Beginnen wir mit der Erforschung von Adobe Firefly Services. Die Untersuchung beginnt mit einem Beispiel für die CitiSignal-Bilderstellung. Das CitiSignal-Designteam möchte eine Neonversion des CitiSignal-Markennamens generieren. Sie würden gerne Adobe Firefly Services nutzen, um das zu tun.

Das erste, was benötigt wird, um dies zu erreichen, ist eine Schwarz-Weiß-Version des CitiSignal Markennamen, etwas, das wie folgt aussieht:

1.1.1.3.1 Erstellen des Referenzbilds für die Komposition

Sie können dieses Beispielbild verwenden oder Ihren eigenen Text zum Experimentieren erstellen. Gehen Sie in Adobe Illustrator wie folgt vor, um Ihre eigene Bilddatei zu erstellen. Wenn Sie das vordefinierte Bild verwenden möchten, überspringen Sie den folgenden Abschnitt und fahren Sie direkt mit Schritt 1.1.1.3.2 Bild erstellen fort.

Öffnen Sie Adobe Illustrator. Klicken Sie auf Neue Datei.

Wählen Sie Web-Large 1920 x 1080px. Klicken Sie auf Erstellen.

Sie sollten dann diese haben. Klicken Sie auf das T-Textsymbol.

Sie sollten dann diese haben.

Ändern Sie den Schrifttyp in eine Schriftart Ihrer Wahl. In diesem Fall ist der Schrifttyp Adobe Clean Bold.

Ändern Sie die Schriftgröße in eine gewünschte Größe, in diesem Fall 250 pt.

Sie sollten dann diese haben.

Ändern Sie den Text wie gewünscht, in diesem Fall CitiSignal.

Zentrieren Sie den Text in der Datei.

Navigieren Sie zu Datei > Exportieren > Für Web speichern (alt)

Sie sollten dann diese haben. Klicken Sie auf Speichern.

Benennen Sie Ihre Datei und speichern Sie sie auf Ihrem Desktop. Klicken Sie auf Speichern.

1.1.1.3.2 Bild erstellen

Navigieren Sie zu https://firefly.adobe.com. Klicken Sie auf Profil-Symbol und stellen Sie sicher, dass Sie beim rechten Konto angemeldet sind, der --aepImsOrgName-- werden sollte. Klicken Sie bei Bedarf auf Profil wechseln, um zu diesem Konto zu wechseln.

Geben Sie den neon light lettering on a brick wall of a night club ein. Klicken Sie Generieren.

Sie sollten dann etwas Ähnliches haben. Diese Bilder sind noch nicht nützlich. Klicken unter Komposition auf „Bild hochladen.

Wählen Sie das zuvor erstellte Bild aus, in diesem Fall ".jpg. Klicken Sie auf Öffnen und dann auf Generieren.

Sie sollten dann etwas Ähnliches haben. Die Anwendung der Kompositionsreferenz ist noch nicht großartig. Um dies zu ändern, ändern Sie den Stärke auf den Maximalwert. Klicken Sie erneut auf Generieren“.

Sie haben jetzt mehrere Bilder, die eine Neonversion des CitiSignal-Markennamen zeigen, die Sie weiter durchlaufen können.

Sie haben jetzt gelernt, Firefly zu verwenden, um ein Design-Problem in wenigen Minuten zu lösen.

1.1.1.4 Erkunden Sie firefly.adobe.com - Schritt 2

Navigieren Sie zu https://firefly.adobe.com/generate/image. Sie sollten das dann sehen. Klicken Sie auf die Modell Dropdown-Liste. Sie werden feststellen, dass es 3 verfügbare Versionen von Adobe Firefly Services gibt:

Klicken Sie, um Firefly Image 3 für diese Übung auszuwählen.

Geben Sie den Horses in a field ein und klicken Sie auf Generieren.

Sie sollten dann etwas Ähnliches sehen.

Öffnen Sie als Nächstes die Entwickler-Tools in Ihrem Browser.

Sie sollten das dann sehen. Wechseln Sie zur Registerkarte Netzwerk. Klicken Sie dann erneut Generieren.

Geben Sie den Suchbegriff "-async“. Anschließend sollte eine Anfrage mit dem Namen "-async“. Wählen Sie es aus und navigieren Sie Payload, wo Sie die Details der Anfrage sehen.

Die Anfrage, die Sie hier sehen, ist die Anfrage, die an das Server-seitige Backend von Firefly Services gesendet wird. Es enthält mehrere wichtige Parameter:

Sehen Sie sich die Benutzeroberfläche noch einmal an. Ändern Sie das Seitenverhältnis auf Breitbild (16:9).

Scrollen Sie nach unten zu Effekte, gehen Sie zu Designs und wählen Sie einen Effekt wie Art Deco aus.

Stellen Sie sicher dass Entwickler-Tools“ noch in Ihrem Browser geöffnet ist. Klicken Sie dann auf Generieren und überprüfen Sie die gesendete Netzwerkanfrage.

Wenn Sie sich die Details der Netzwerkanfrage ansehen, sehen Sie Folgendes:

Für die nächste Übung müssen Sie eine der Seed Zahlen verwenden. Notieren Sie sich eine Testnummer Ihrer Wahl.

In der nächsten Übung machen Sie ähnliche Dinge mit Firefly Services, aber verwenden Sie dann die API anstelle der Benutzeroberfläche. In diesem Beispiel ist die Seed-Nummer für das erste Bild 142194, das aus zwei Pferden besteht, die sich mit dem Kopf anschauen.

1.1.1.5 Adobe I/O - access_token

Wählen Sie in der Sammlung Adobe IO - OAuth die Anfrage mit dem Namen POST - Zugriffstoken abrufen und klicken Sie auf Senden. Die Antwort sollte ein neues "_token“.

1.1.1.6 Firefly Services-API, Text 2 Bild, Bild 3

Nachdem Sie nun über ein gültiges und neues Zugriffs-Token verfügen, können Sie Ihre erste Anfrage an Firefly Services-APIs senden.

Die Anfrage, die Sie hier verwenden werden, ist eine asynchrone Anfrage, die Ihnen eine Antwort liefert, die die URL des gesendeten Auftrags enthält. Das bedeutet, dass Sie eine zweite Anfrage verwenden müssen, um den Status des Auftrags zu überprüfen und auf das generierte Bild zuzugreifen.

Wählen Sie die Anfrage POST - Firefly - T2I V3 async aus der Sammlung FF - Firefly Services Tech Insiders aus. Navigieren Sie zu Kopfzeilen und überprüfen Sie die Schlüssel/Wert-Paarkombinationen.

Beide Werte in dieser Anfrage beziehen sich auf Umgebungsvariablen, die zuvor definiert wurden. {{API_KEY}} bezieht sich auf das Feld Client-ID Ihres Adobe I/O-Projekts. Im Rahmen des Abschnitts Erste Schritte dieses Tutorials haben Sie dies in Postman konfiguriert.

Der Wert für das Feld Autorisierung ist etwas spezieller: Bearer {{ACCESS_TOKEN}}. Sie enthält einen Verweis auf das Zugriffstoken, das Sie im vorherigen Schritt generiert haben. Wenn Sie Ihr Zugriffs-Token mithilfe der Anfrage POST - Zugriffs-Token abrufen in der Adobe IO - OAuth-Sammlung erhalten haben, wurde in Postman ein Skript ausgeführt, das das Feld Zugriffs-Token als Umgebungsvariable speichert. Auf dieses wird jetzt in der Anfrage POST - Firefly - T2I V3 asynchron. Bitte beachten Sie die spezifische Ergänzung des Wortes Träger und ein Leerzeichen vor dem {{ACCESS_TOKEN}}. Bei dem Wort „Bearer“ wird zwischen Groß- und Kleinschreibung unterschieden und es wird ein Leerzeichen benötigt. Wenn dies nicht korrekt ausgeführt wird, gibt Adobe I/O den Fehler 401 Unauthorized zurück, da es Ihr (Zugriffs Token) kann.

Wechseln Sie dann zum Textkörper und überprüfen Sie die Eingabeaufforderung. Klicken Sie auf Senden.

Sie erhalten dann eine sofortige Antwort. Diese Antwort enthält nicht die Bild-URLs des generierten Bildes, sondern eine URL des Statusberichts des von Ihnen ausgeführten Auftrags sowie eine weitere URL, mit der Sie den ausgeführten Auftrag abbrechen können.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Sie sollten eine ähnliche Antwort erhalten haben. Dies ist die Übersicht über den ausgeführten Auftrag. Sie können das Feld url sehen, das das generierte Bild enthält. Kopieren Sie die Bild-URL aus der Antwort (oder klicken Sie darauf) und öffnen Sie sie in Ihrem Webbrowser, um das Bild anzuzeigen.

Sie sollten ein schönes Bild sehen, das horses in a field darstellt.

Fügen Sie im Hauptteil Ihrer Anfrage POST - Firefly - T2I V3 async Folgendes unter dem Feld "promptBiasingLocaleCode": "en-US" hinzu und ersetzen Sie die Variable XXX durch eine der Seed-Nummern, die von der Firefly Services-Benutzeroberfläche zufällig verwendet wurden. In diesem Beispiel wird die Seed-Nummer 142194.

,
  "seeds": [
    XXX
  ]

Klicken Sie Senden. Sie erhalten dann erneut eine Antwort mit einem Link zum Statusbericht des gerade gesendeten Auftrags.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Anschließend sollte ein neues Bild mit leichten Unterschieden angezeigt werden, das auf dem verwendeten Seed basiert. Die 142194 besaßen zwei Pferde, die sich mit dem Kopf anschauten.

Fügen Sie als Nächstes im Hauptteil Ihrer Anfrage POST - Firefly - T2I V3 async das folgende styles-Objekt unter das seed-Objekt ein. Dadurch wird der Stil des erzeugten Bildes in "_deco“.

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

Sie sollten dann diese haben. Klicken Sie Senden. Sie erhalten dann erneut eine Antwort mit einem Link zum Statusbericht des gerade gesendeten Auftrags.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Ihr Bild hat sich jetzt etwas verändert. Beim Anwenden von Stilvorgaben wird das Seed-Bild nicht mehr auf die gleiche Weise wie zuvor angewendet. Insgesamt ist es bei generativer KI sehr schwer zu garantieren, dass dieselbe Kombination von Eingabeparametern dazu führt, dass dasselbe Bild generiert wird.

Entfernen Sie den Code für das seed-Objekt aus dem body Ihrer POST - Firefly - T2I V3 async-Anfrage. Klicken Sie Senden und dann auf die Bild-URL, die Sie aus der Antwort erhalten. Sie erhalten dann erneut eine Antwort mit einem Link zum Statusbericht des gerade gesendeten Auftrags.

,
  "seeds": [
    XXX
  ]

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Ihr Bild hat sich jetzt wieder etwas verändert.

1.1.1.7 Firefly Services-API, Gen-Erweiterung

Wählen Sie die Anfrage POST - Firefly - Gen Expand async) aus der FF - Firefly Services Tech Insiders-Sammlung aus und navigieren Sie zum Hauptteil der Anfrage.

Sie erhalten dann erneut eine Antwort mit einem Link zum Statusbericht des gerade gesendeten Auftrags.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Sie sehen nun, dass das in der vorherigen Übung generierte Bild auf die Auflösung von 3999x3999 erweitert wurde.

Erstellen Sie ein neues Bild mithilfe der asynchronen Anfrage Firefly - T2I V3.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Anschließend sollten Sie ein ähnliches Bild sehen.

Wählen Sie die Anfrage POST - Firefly - Gen Expand async) aus der FF - Firefly Services Tech Insiders-Sammlung aus und navigieren Sie zum Hauptteil der Anfrage.

Wenn Sie die Ausrichtung der Platzierung ändern, unterscheidet sich die Ausgabe ebenfalls geringfügig. In diesem Beispiel wird die Platzierung in ", unten“. Klicken Sie Senden. Sie erhalten dann erneut eine Antwort mit einem Link zum Statusbericht des gerade gesendeten Auftrags.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Anschließend sollte man sehen, dass das Originalbild an einer anderen Stelle verwendet wird, was das gesamte Bild beeinflusst.

1.1.1.8 Firefly Services-API, Text 2 Bild, Bild 4 und Bild 4 Ultra

Mit der kürzlich veröffentlichten Version von Firefly Image Model 4 wurden mehrere Verbesserungen vorgenommen:

Mit Firefly Image Model 4 erhalten Sie außergewöhnliche Bilder von Menschen, Tieren und detaillierten Szenen. Mit Image Model 4 Ultra können Sie Bilder mit hyperrealistischen menschlichen Interaktionen, Architekturelementen und komplexen Landschaften erzeugen​

1.1.1.8.1 image4_standard

Wählen Sie die Anfrage POST - Firefly - T2I V4 aus der FF - Firefly Services Tech Insiders-Sammlung aus und navigieren Sie zu Headers der Anfrage.

Sie werden feststellen, dass sich die URL der Anfrage von der Firefly Services-API, Text 2 Bild, Bild 3-Anfrage unterscheidet, die https://firefly-api.adobe.io/v3/images/generate war. Diese URL verweist auf https://firefly-api.adobe.io/v3/images/generate-async. Das Hinzufügen von -async in der URL bedeutet, dass Sie den asynchronen Endpunkt verwenden.

In Header-Variablen fällt Ihnen eine neue Variable mit dem Namen x-model-version auf. Dies ist eine erforderliche Kopfzeile bei der Interaktion mit Firefly Image 4 und Image 4 Ultra. Um beim Generieren von Bildern Firefly Image 4 oder Image 4 Ultra zu verwenden, sollte der Wert der -Kopfzeile entweder auf image4_standard oder image4_ultra festgelegt werden. In diesem Beispiel verwenden Sie image4_standard.

Wenn Sie die x-model-version nicht auf image4_standard oder image4_ultra setzen, verwendet Firefly Services standardmäßig image3.

Navigieren Sie zum Hauptteil der Anfrage. Sie sollten sehen, dass im Hauptteil vier Bildvarianten angefordert werden. Die Eingabeaufforderung ist unverändert und fordert immer noch die Generierung von Pferden auf einem Feld. Klicken Sie auf Senden

Sie erhalten dann eine sofortige Antwort. Diese Antwort enthält nicht die Bild-URLs des generierten Bildes, sondern eine URL des Statusberichts des von Ihnen ausgeführten Auftrags sowie eine weitere URL, mit der Sie den ausgeführten Auftrag abbrechen können.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden.

Anschließend wird der Statusbericht des gerade gestarteten Image-Generierungsvorgangs angezeigt. Überprüfen Sie das Feld Status, da es möglicherweise auf Wird ausgeführt festgelegt ist, was bedeutet, dass der Vorgang noch nicht abgeschlossen ist. In diesem Beispiel ist der Auftragsstatus auf Erfolgreich festgelegt, was bedeutet, dass die von Ihnen angeforderten Bilder generiert wurden.

Scrollen Sie in der Antwort etwas nach unten, und Sie sollten dann sehen, dass insgesamt 4 Bildvarianten von Adobe Firefly Services zurückgegeben werden. Klicken (oder kopieren) Sie die URL eines der Bilder und öffnen Sie sie in Ihrem Browser.

Dann sollte man ein hyperrealistisches Bild von Pferden auf einem Feld sehen.

1.1.1.8.2 image4_ultra

Kehren Sie zur Anfrage mit dem Namen POST - Firefly - T2I V4 aus der FF - Firefly Services Tech Insiders-Sammlung zurück und navigieren Sie zu Headers der Anfrage.

Ändern Sie die Variable x-model-version in image4_ultra. In diesem Beispiel verwenden Sie image4_ultra.

Navigieren Sie zum Hauptteil der Anfrage. Ändern Sie im Hauptteil die Anzahl der Bildvarianten in 1. Wie bei Firefly Image 4 Ultra kann nur 1 Bild gleichzeitig generiert werden. Die Eingabeaufforderung ist unverändert und fordert immer noch die Generierung von Pferden auf einem Feld. Klicken Sie auf Senden

Die Antwort enthält wiederum eine URL des Statusberichts des von Ihnen ausgeführten Auftrags und eine weitere URL, mit der Sie den ausgeführten Auftrag abbrechen können.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden.

Anschließend wird der Statusbericht des gerade gestarteten Image-Generierungsvorgangs angezeigt. Überprüfen Sie das Feld Status, da es möglicherweise auf Wird ausgeführt festgelegt ist, was bedeutet, dass der Vorgang noch nicht abgeschlossen ist. In diesem Beispiel ist der Auftragsstatus auf Erfolgreich festgelegt, was bedeutet, dass die von Ihnen angeforderten Bilder generiert wurden.

Dann sollte man ein hyperrealistisches Bild von Pferden auf einem Feld sehen.

Negative Eingabeaufforderung

Wenn Sie Firefly auffordern möchten, etwas nicht in das zu generierende Bild aufzunehmen, können Sie bei Verwendung der API die negativePrompt einbeziehen (diese Option wird derzeit nicht in der Benutzeroberfläche angezeigt). Wenn Sie beispielsweise möchten, dass bei der Eingabeaufforderung Pferde in einem Feld keine Blumen eingeschlossen werden, können Sie dies im Hauptteil Ihrer API-Anfrage angeben:

"negativePrompt": "no flowers",

Rufen Sie die Anfrage POST - Firefly - T2I V4 aus der FF - Firefly Services Tech Insiders-Sammlung auf und navigieren Sie zum Hauptteil der Anfrage. Fügen Sie den obigen Text in den Textkörper der Anfrage ein. Klicken Sie auf Senden.

Sie sollten das dann sehen.

Um den Statusbericht Ihres laufenden Auftrags zu überprüfen, wählen Sie die Anfrage mit dem Namen GET - Firefly - Statusbericht abrufen aus der Sammlung FF - Firefly Services Tech Insiders aus. Klicken Sie auf , um es zu öffnen, und klicken Sie dann auf Senden. Wählen Sie die URL des generierten Bildes aus und öffnen Sie es in Ihrem Browser.

Daraufhin wird das generierte Bild angezeigt, das keine Blumen enthalten sollte.

Nächste Schritte

Navigieren Sie zu Optimieren Ihres Firefly-Prozesses mit Microsoft Azure und vordefinierten URLs

Zurück zu Übersicht über Adobe Firefly Services

Zurück zu Alle Module