Automatisiere deinen Postproduktions-Workflow mit der Imagen-API

  • Aktualisiert

Imagen auf einen Blick

Imagen ist eine KI-basierte Lösung, die professionellen Fotografen stundenlange Arbeit in der Postproduktion abnimmt. 

Wie funktioniert das? 

Fotografen erstellen ein KI-Profil oder wählen ein Talent- oder Imagen-KI-Profil aus. Anschließend laden sie ihre Fotos auf Imagen hoch. Imagen bearbeitet die Fotos mithilfe des KI-Profils in einem Bruchteil der Zeit, die der manuelle Prozess in Anspruch nimmt. Anschließend exportiert Imagen die Fotos und liefert sie an die Kunden.

Die Imagen-API rationalisiert und automatisiert den Bearbeitungs-Workflow in der Postproduktion des Fotografen, ähnlich wie die Imagen-App. Dieses Dokument erklärt den Workflow und die Endpunkte, die aufgerufen werden müssen.

Dies sind die wichtigsten Schritte bei der Verwendung der Imagen-API: 

  1. KI-Profil auswählen – Probiere KI-Profile aus, um das richtige Profil für deine Bearbeitungen mit der Imagen-API zu finden.
  2. Erstelle eine Bildauswahl deiner Fotos, bevor du sie zur Bearbeitung hochlädst. Die Bildauswahl ist nicht Teil der Imagen-API.
  3. Fotos bearbeiten – Lade Fotos in den S3-Bucket von Imagen auf AWS hoch, um sie mit einem KI-Profil und KI-Werkzeugen zu bearbeiten.
  4. Fotos zur Lieferung exportieren – Exportiere die bearbeiteten Fotos im JPEG-Format in ein Projekt. Dieser Schritt ist optional. Einige Unternehmen ziehen es vor, die Fotos mit ihrer eigenen Bildbearbeitungssoftware zu bearbeiten und zu exportieren.

Bevor du beginnst

Voraussetzungen

Um die Imagen-API nutzen zu können, musst du dich bei Imagen registrieren.  Sende dann eine E-Mail an das Imagen Customer Success Team, um einen API-Schlüssel anzufordern. Bitte gib in deiner E-Mail die E-Mail-Adresse an, mit der du dich bei Imagen registriert hast.

Imagen-Basis-URL

Die Basis-URL für die Imagen-API lautet https://api-beta.imagen-ai.com/v1/.

API-Referenzdokumentation

Hier findest du die API-Referenzdokumentation für die Imagen-API.

Authentifizierung

Die Imagen-API verwendet einen API-Schlüssel für die Authentifizierung. Füge ihn als Header im Textformat zu deinen Anfragen hinzu. Der Name des Headers lautet x-api-key. 

Hier ein Beispiel:

curl --location ‘https://api-beta.imagen-ai.com/v1/profiles/’ \

--header ‘x-api-key: ’ \

--header ‘Content-Type: application/json’ 

Unterstützte Dateiformate für die Bildbearbeitung

Die Imagen-API unterstützt die folgenden Dateiformate für die Bildbearbeitung:

  • RAW: NEF, CR2, CR3, ARW, NRW, CRW, SRF, SR2, ORF, RW2, RAF, PTX, PEF, RWL, SRW, 3FR und FFF
  • DNG
  • JPEG 

KI-Profil auswählen

KI-Profile sagen den Bearbeitungsstil eines Fotografen voraus und bearbeiten die Fotos entsprechend. Imagen bietet viele kostenlose KI-Profile an, oder du kannst eines aus deinen Fotos erstellen. 

Du wählst ein KI-Profil aus, das zu den Fotos passt, die du bearbeiten möchtest. Achte darauf, dass es zum Dateiformat und zum Bearbeitungsstil deiner Fotos passt. Rufe dann den Endpunkt /profiles/ auf, um eine Liste aller verfügbaren Profile zu erhalten. In der Antwort findest du den profile_key des Profils, das du verwenden möchtest.

  1. Bearbeite deine Fotos online, um ein KI-Profil auszuwählen, das dir gefällt. Du kannst bis zu 10 RAW-Fotos hochladen und erhältst schnell Ergebnisse.  Wenn du kein passendes Profil findest, kannst du mit der Imagen-App ein Personal-AI-Profil erstellen.
  2. Rufe eine Liste der KI-Profile und ihrer Schlüssel ab.

Rufe GET https://api-beta.imagen-ai.com/v1/profiles/ auf, um eine Liste der KI-Profile zu erhalten, die für die Bearbeitung deiner Fotos zur Verfügung stehen. 

Die Antwort enthält die persönlichen KI-Profile, die du in der Imagen-Anwendung erstellt hast, sowie alle verfügbaren Talent- und Imagen-KI-Profile. Jedes KI-Profil hat einen profile_key, der es identifiziert. Diesen profile_key brauchst du, wenn du die Fotos in deinem Projekt bearbeitest.

Beispiel einer Antwort mit einer Auswahl der verfügbaren KI-Profile

{

    "data": {

        "profiles": [

            {

                "profile_key": ,

                "profile_name": "Wedding",

                "profile_type": "Personal",

                "image_type": "RAW"

            },

            {

                "profile_key": 14715,

                "profile_name": "LOVE & LIGHT",

                "profile_type": "Talent",

                "image_type": "RAW"

            },

            {

                "profile_key": 163322,

                "profile_name": "ELEGANT HOME",

                "profile_type": "Talent",

                "image_type": "RAW"

            }

        ]

    }

}



Auswahl von KI-Werkzeugen zur Verbesserung der Bearbeitung

KI-Werkzeuge bieten zusätzliche KI-gestützte Fotobearbeitung, um die Fotobearbeitung in deinem Projekt zu verbessern. Du kannst die KI-Werkzeuge nach deinen Bedürfnissen kombinieren. Einige KI-Werkzeuge schließen sich gegenseitig aus, sodass du dich für das eine oder andere entscheiden musst. Andere sind für bestimmte Arten von Fotos gedacht, zum Beispiel für Immobilien oder Sport. 

In diesem Abschnitt erfährst du, wie du KI-Werkzeuge auswählst. Später fügst du die KI-Werkzeuge der Bearbeitungsanfrage hinzu.

Imagen-KI-Werkzeuge

KI-Werkzeug-Parameter Beschreibung
crop Schneidet deine Bilder auf ein Seitenverhältnis von 2 x 3 zu, um bei vielen Fototypen eine optimale Komposition zu ermöglichen. Kann nicht zusammen mit headshot_crop oder portrait_cropverwendet werden.
headshot_crop Richtet all deine Porträtfotos einheitlich aus und passt sie an deine Größe an, wodurch sie sich ideal für Jahrbücher und als professionelle Porträtfotos eignen. Diese Funktion zentriert das Motiv und richtet die Augen bei allen Fotos auf dieselbe horizontale Linie aus. Kann nicht zusammen mit crop oder portrait_cropverwendet werden.
hdr_merge Kombiniert mehrere Fotos mit unterschiedlichen Belichtungen zu einem Foto, sodass sowohl die Außen- als auch die Innenbelichtung korrekt sind. Wird am häufigsten für Immobilienfotos verwendet. Siehe HDR Merge für die Anforderungen.
perspective_correction Korrigiert Verzerrungen in der Immobilienfotografie, die durch Weitwinkelobjektive oder ungünstige Aufnahmewinkel verursacht werden, sodass vertikale und horizontale Linien gerade sind. Kann nicht in Verbindung mit straighten verwendet werden.
portrait_crop Zentriert das Hauptmotiv jedes Fotos und schneidet es auf das Seitenverhältnis 4 x 5 zu. Behält den optimalen Abstand über dem Kopf und andere wichtige Details bei. Empfohlen für Porträt-, Studio-, Schul- und Sportfotografie. Kann nicht zusammen mit crop oder headshot_crop verwendet werden.
straighten Dreht jedes Foto entsprechend seinem Horizont. Kann nicht mit perspective_correction verwendet werden.
subject_mask Wählt das Hauptmotiv des Fotos ähnlich wie in Lightroom aus, wendet eine Maske mit Pinseln an und dann eine lokale KI-Bearbeitung auf diese Maske an.
smooth_skin Reduziert die Sichtbarkeit von Unregelmäßigkeiten wie feinen Linien und Flecken und sorgt so für einen gepflegten und attraktiven Teint.

 

Sich gegenseitig ausschließende KI-Werkzeuge

Einige ähnliche KI-Werkzeuge schließen einander aus. Wähle entweder:

  • crop, headshot_crop, oder portrait_crop
  • perspective_correction oder straighten.

KI-Werkzeuge für verschiedene Fototypen

Immobilien

Für Immobilienfotografie solltest du hdr_merge und perspective_correction verwenden. Vermeide das KI-Werkzeug straighten.

Schule und Sport

Für Schul- und Sportfotografie solltest du portrait_crop verwenden.

Allgemein für alle Typen

Diese KI-Werkzeuge eignen sich für die meisten Arten von Fotografie.

  • crop
  • straighten
  • subject_mask
  • smooth_skin

 

Fotos bearbeiten

1. Erstelle ein Projekt

Rufe POST https://api-beta.imagen-ai.com/v1/projects/ auf, um ein Projekt zu erstellen.

Wir empfehlen dir, für jedes Fotoshooting ein separates Projekt zu erstellen. Ein Projekt organisiert deine Fotos mit dem KI-Profil, das du für die Bearbeitung dieser Fotos ausgewählt hast. Die Antwort ist die project_uuid und wird verwendet, um dieses Projekt zu identifizieren. Verwende diese project_uid, bis du deine Fotos als JPEG exportierst.

Beispiel einer Antwort

{

    "data": {

        "project_uuid": ""

    }

}

 

2. Erhalte temporäre Upload-Links, um Fotos hochzuladen

Rufe POST https://api-beta.imagen-ai.com/v1/projects//get_temporary_upload_links auf.

Gib in der Anfrage im Parameter files_list die Dateinamen der hochzuladenden Fotos an. Verwende das Format list.

Die Antwort enthält einen temporären Link für jedes Foto zum S3-Bucket von Imagen auf AWS. Dieser Link ist die von AWS vorgegebene URL.

Beispiel einer Anfrage

curl --location ‘https://api.dev.imagen-ai.com/v1/projects//get_temporary_upload_links’ \

--header ‘x-api-key: ’ \

--header ‘Content-Type: application/json’ \

--data ‘{

    “files_list”: [

        {“file_name”: “922A4846.CR2”},

        {“file_name”: “922A4832.CR2”},

        {“file_name”: “922A4818.CR2”},

        {“file_name”: “922A4809.CR2”}

    ]

}’

 

Beispiel einer Antwort

{

    "data": {

        "files_list": [

            {

                "file_name": "922A4846.raw",

                "upload_link": ""

            },

            {

                "file_name": "922A4832.raw",

                "upload_link": ""

            },

            {

                "file_name": "922A4818.raw",

                "upload_link": ""

            },

            {

                "file_name": "922A4809.raw",

                "upload_link": ""

            }

        ]

    }

}



3. Lade jedes Foto auf seinen temporären Upload-Link hoch

Lade die Fotos in den S3-Bucket von Imagen auf AWS hoch, indem du die temporären Upload-Links aus der Antwort im vorherigen Schritt verwendest. Du kannst jede beliebige Methode verwenden.

Weitere Informationen zum Hochladen von Dateien mit einer vorausgefüllten URL findest du in dieser Anleitung in der AWS-Dokumentation.

Testen in Postman

  • Content-Type aus der Kopfzeile löschen.
  • Füge in der Registerkarte Params einen neuen Parameter namens Content-Type mit einem leeren String ("") als Wert hinzu.

Anforderungen an die Kopfzeile einer Anfrage

Wenn du md5 im Parameter files_list der Anfrage für die temporären Upload-Links angegeben hast, musst du auch MD5 im Request-Header angeben, um die Bilder hochzuladen. Einen Beispielcode in Python findest du in api_client.py im Imagen-API-Projekt in Github.

Textanforderungen anfordern

Füge im Anforderungstext Content-Type als Abfrageparameter mit einer leeren Zeichenfolge ("") als Wert hinzu.

4. Starte die Bearbeitung 

Rufe POST https://api-beta.imagen-ai.com/v1/projects//edit auf, um die Bearbeitung mit dem gewählten KI-Profil zu starten. 

Füge in den Anfragetext ein:

Beispiel für einen Anfragetext

{

  "profile_key": ,

  "hdr_merge": true,

  "photography_type": "NO_TYPE",

  "callback_url": "string",

  "perspective_correction": true

}

Als Antwort erhältst du eine Nachricht, dass das Projekt erfolgreich bearbeitet wurde. Sollte ein Fehler aufgetreten sein, sende bitte eine E-Mail an unser Customer Success Team.

Profilschlüssel

Der profile_key ist eine Kennung für das KI-Profil, das du zur Bearbeitung deines Projekts verwendest. Verwende das Ganzzahlformat. Siehe die Antwort unter Ein KI-Profil auswählen, um deinen profile_key zu erhalten.

KI-Werkzeuge

Ein KI-Werkzeug ist ein zusätzliches KI-gesteuertes Fotobearbeitungswerkzeug, das bei der Bearbeitung von Fotos im Projekt hinzugefügt werden kann. 

Fototyp

Der photography_type gibt an, welche Art von Fotos im Projekt aufgenommen wurde. Dieser Parameter ist optional. 

Hier sind die Werte für photography_type:

  • WEDDING
  • REAL_ESTATE
  • SCHOOL
  • SPORTS
  • EVENTS
  • PORTRAITS
  • NO_TYPE
  • OTHER
  • LANDSCAPE_NATURE
  • FAMILY_NEWBORN
  • BOUDOIR

Callback-URL

Die callback_url ist ein POST-Endpunkt, den Imagen verwenden kann, um Statusmeldungen an die API zu senden. Dieser Parameter ist optional. Wenn du ihn verwendest, musst du nicht den Bearbeitungsstatus überprüfen. Dieser Endpunkt muss für Imagen offen sein. 

Mögliche Statusoptionen, die mit der Anfrage gesendet werden, sind:

Beispiel einer Antwort

{“project_uuid”: “”, “status”: “Failed/Completed”, “action”: “edit/export”“}



5. Überprüfe den Bearbeitungsstatus

Rufe GET https://api-beta.imagen-ai.com/v1/projects//edit/status auf, um den aktuellen Status des Bearbeitungsprozesses zu erhalten. Rufe diesen Endpunkt mit langen Anfragen auf, bis der Status Completed erreicht ist.

Um diese Statusprüfung zu umgehen, kann die callback_url in die Anfrage /projects//edit/ eingefügt werden. Siehe Callback-URL für weitere Informationen.

Hier sind die Statusoptionen in der Antwort:

 

6. Erstelle temporäre Download-Links, um die verarbeiteten Fotos herunterzuladen

Wenn der Status COMPLETED anzeigt, rufe GET https://api-beta.imagen-ai.com/v1/projects//edit/get_temporary_download_link auf. 

Gib in der Anfrage im Parameter files_list die Fotos an, die du herunterladen möchtest. Verwende das Format list.

Die Antwort enthält einen temporären Link für jedes Foto zum S3-Bucket von Imagen auf AWS. Dieser Link ist die von AWS vorgegebene URL.

Beispiel einer Antwort

{

    "data": {

        "files_list": [

            {

                "file_name": "922A4846.DNG",

                "upload_link": ""

            },

            {

                "file_name": "922A4832.DNG",

                "upload_link": ""

            },

            {

                "file_name": "922A4818.DNG",

                "upload_link": ""

            },

            {

                "file_name": "922A4809.DNG",

                "upload_link": ""

            }

        ]

    }

}

 

7. Lade Fotos lokal herunter

Imagen gibt die bearbeiteten Dateien in den folgenden Formaten zurück: 

Dateiformat vor dem Bearbeiten Dateiformat nach dem Bearbeiten
RAW XMP
Hinweis: Wenn du Fotos mit „HDR Merge“ bearbeitest, ist das zurückgegebene Format immer DNG, auch wenn das Dateiformat vor der Bearbeitung RAW war.
DNG DNG mit eingebettetem XMP
JPEG JPEG mit eingebettetem XMP


Lade die Fotos aus dem S3-Bucket von Imagen auf AWS herunter, indem du die temporären Download-Links aus der Antwort im vorherigen Schritt verwendest. Du kannst jede beliebige Methode verwenden. Einen Beispielcode in Python findest du in api_client.py im Imagen-API-Projekt in Github.

Weitere Informationen zum Herunterladen von Dateien von AWS findest du in dieser Anleitung in der AWS-Dokumentation.

Fotos zur Lieferung exportieren

Die Imagen-API exportiert alle Fotos eines Projekts im JPEG-Format. Dieser Schritt ist optional. Einige Fotografen bearbeiten die Fotos und exportieren sie mit ihrer Bildbearbeitungssoftware. Sobald die Fotos exportiert sind, können sie geliefert oder in eine Galerie hochgeladen werden.

1. Exportiere die Fotos im Projekt

Rufe POST https://api-beta.imagen-ai.com/v1/projects//export auf. Die Antwort enthält die project_uuid und eine Nachricht, dass der Export erfolgreich war. Sollte ein Fehler aufgetreten sein, sende bitte eine E-Mail an unser Customer Success Team.

2. Überprüfe den Exportstatus

Rufe GET https://api-beta.imagen-ai.com/v1/projects//export/status auf. Die Antwort enthält den Exportstatus. Mögliche Statusoptionen:

  • IN PROGRESS: Die Imagen-API bearbeitet die Fotos.
  • FAILED: Sende eine E-Mail an das Customer Success Team.
  • COMPLETED: Die Imagen-API hat den Export der Fotos im JPEG-Format abgeschlossen. 

3. Lade exportierte JPEG-Fotos herunter

Erhalte temporäre Download-Links, um exportierte JPEG-Fotos herunterzuladen

Wenn der Exportstatus COMPLETED ist, rufe GET https://api-beta.imagen-ai.com/v1/projects//export/get_temporary_download_links auf. 

Gib in der Anfrage im Parameter files_list die Fotos an, die du herunterladen möchtest. Verwende das Format list.

Die Antwort enthält einen temporären Link für jedes Foto zum S3-Bucket von Imagen auf AWS. Dieser Link ist die von AWS vorgegebene URL.

Beispiel einer Antwort

{

    "data": {

        "files_list": [

            {

                "file_name": "922A4846.JPG",

                "upload_link": ""

            },

            {

                "file_name": "922A4832.JPG",

                "upload_link": ""

            },

            {

                "file_name": "922A4818.JPG",

                "upload_link": ""

            },

            {

                "file_name": "922A4809.JPG",

                "upload_link": ""

            }

        ]

    }

}

 

Lade exportierte JPEG-Fotos lokal herunter

Lade die Fotos aus dem S3-Bucket von Imagen auf AWS herunter, indem du die temporären Download-Links aus der Antwort im vorherigen Schritt verwendest. Du kannst jede beliebige Methode verwenden. Einen Beispielcode in Python findest du in api_client.py im Imagen-API-Projekt in Github.

Weitere Informationen zum Herunterladen von Dateien von AWS findest du in dieser Anleitung in der AWS-Dokumentation.

War dieser Beitrag hilfreich?

Haben Sie Fragen? Anfrage einreichen