Automatiser votre flux de travail de post-production avec l’API Imagen

  • Mise à jour

Aperçu d’Imagen

Imagen est une solution alimentée par l’IA qui allège les photographes professionnels des chronophages tâches de post-production. 

Comment ça marche ? 

Les photographes créent un Profil IA ou choisissent un Profil Talent ou Imagen IA. Ensuite, ils téléchargent des photos sur Imagen. Imagen édite les photos avec leur Profil IA en un temps infiniment plus court que ce que le processus manuel prendrait. Enfin, ils exportent les photos et les livrent à leurs clients.

L’API Imagen rationalise et automatise le flux de travail de post-production du photographe, à l’instar de l’application Imagen. Ce document détaille le flux et les critères que vous devez solliciter.

Les principales étapes de l’utilisation de l’API Imagen sont les suivantes : 

  1. Sélectionner un Profil IA – Essayez les Profils IA pour en trouver un à utiliser pour l’édition, avec l’API Imagen.
  2. Triez vos photos avant de les télécharger pour les éditer. Le tri ne fait pas partie de l'API Imagen.
  3. Éditer les photos – Téléchargez des photos dans le bucket S3 d'Imagen sur AWS pour les éditer avec un Profil IA et des outils IA.
  4. Exporter les photos pour la livraison – Exportez les photos éditées dans un projet au format JPEG. Cette étape n’est pas obligatoire. Certaines entreprises préfèrent modifier les éditions et exporter des photos avec leur logiciel d’édition.

Avant de commencer

Conditions préalables

Vous devez vous inscrire à Imagen avant de pouvoir utiliser l’API Imagen.  Ensuite, envoyez un e-mail à l’équipe du service client d’Imagen pour lui demander une clé API. Dans votre e-mail, indiquez l’adresse e-mail que vous avez utilisée pour vous inscrire à Imagen.

URL de base Imagen

L’URL de base de l’API Imagen est https://api-beta.imagen-ai.com/v1/.

Documents API de référence

Voici la documentation de référence de l’API pour l’API Imagen.

Authentification

L’API Imagen utilise une clé API pour l’authentification. Ajoutez-la dans l’en-tête de vos demandes au format texte. Le nom de l’en-tête est x-api-key. 

Voici un exemple :

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

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

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

Formats de fichier pris en charge pour l’édition de photos

L’API Imagen prend en charge ces formats de fichier pour l’édition de photos :

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

Sélectionner un Profil IA

Les Profils IA prédisent le style d’édition d’un photographe, puis éditent les photos en conséquence. Imagen propose gratuitement de nombreux Profils IA, ou vous permet d’en créer un à partir de vos photos. 

Vous choisissez un Profil IA qui sera compatible avec les photos que vous souhaitez éditer. Assurez-vous de faire correspondre le format de fichier et le style d’édition de vos photos. Ensuite, sollicitez le critère /profiles/ pour obtenir une liste de tous les profils disponibles. Dans la réponse, vous trouvez le profile_key de celui que vous souhaitez utiliser.

  1. Éditez vos photos en ligne pour choisir un Profil IA que vous aimez. Vous pouvez télécharger jusqu’à 10 photos RAW et obtenir rapidement des résultats.  Si vous n’en trouvez aucun qui vous plaise, utilisez l’application Imagen pour créer un Profil personnel IA.
  2. Obtenez une liste des Profils IA et leurs clés.

Lancez la commande GET https://api-beta.imagen-ai.com/v1/profiles/ pour obtenir une liste des Profils IA disponibles pour éditer vos photos. 

La réponse comprend les Profils Personnels IA que vous avez créés dans l’application Imagen et tous les Profils Talents et IA Imagen disponibles. Chaque Profil IA dispose d’un profile_key qui l’identifie. Vous aurez besoin de ce profile_key lors de l’édition des photos de votre projet.

Exemple de réponse avec un échantillon des Profils IA disponibles

{

    "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"

            }

        ]

    }

}



Choisir des outils IA pour améliorer l’édition

Les outils d’IA offrent un traitement photo supplémentaire alimenté par l’IA qui améliore l’édition des photos dans le projet. Vous pouvez faire un mix & match d’outils IA en fonction de vos besoins. Certains outils IA sont mutuellement exclusifs, vous devez donc choisir l’un ou l’autre. D’autres sont adaptés à des types de photographie spécifiques comme l’immobilier ou le sport. 

Dans cette section, nous expliquons comment choisir des outils IA. Plus tard dans le processus, vous ajoutez les outils IA à la demande d’édition.

Outils IA Imagen

Paramètre outil IA Description
crop Recadre l’image à un format 2 x 3 pour une composition optimale dans de nombreux types de photographie. Il ne peut pas être utilisé avec headshot_crop ou portrait_crop.
headshot_crop Aligne et dimensionne tous vos portraits de manière cohérente, ce qui le rend idéal pour un album de fin d'année et les portraits professionnels. Il centre le sujet et aligne les yeux sur la même ligne horizontale, sur toutes les photos. Il ne peut pas être utilisé avec crop ou portrait_crop.
hdr_merge Combine plusieurs photos avec différentes expositions dans une seule photo afin que l’exposition pour l’extérieur et l’exposition pour l’intérieur soient toutes les deux correctes. Il est principalement utilisé pour la photographie de biens immobiliers. Voir HDR Merge pour les exigences.
perspective_correction Corrige les distorsions dans la photographie de biens immobiliers causées par des objectifs grand angle ou des angles de prise de vue imparfaits afin que les lignes verticales et horizontales soient droites. Il ne peut pas être utilisé avec redressement.
portrait_crop Centre le sujet principal de chaque photo, puis le recadre avec un format 4 x 5. Il maintient un espacement optimal au-dessus de la tête et assure d’autres détails clés. Recommandé pour les prises de vue de portraits et de studio ainsi que pour l’école et le sport. Il ne peut pas être utilisé avec crop ou headshot_crop.
straighten Fait pivoter chaque photo en fonction de son horizon. Il ne peut pas être utilisé avec perspective_correction.
subject_mask Sélectionne le sujet principal de la photo de la même manière que Lightroom, applique un masque à l’aide de pinceaux, puis applique une édition IA locale à ce masque.
smooth_skin Réduit la visibilité des imperfections de la peau, telles que les ridules et les imperfections, ce qui donne un teint plus lisse et visuellement attrayant.

 

Outils IA mutuellement exclusifs

Certains outils IA similaires sont mutuellement exclusifs les uns des autres. Choisissez l'une des options suivantes :

  • crop, headshot_crop ou portrait_crop
  • perspective_correction ou redressement.

Outils IA pour différents types de photographie

Immobilier

Pour la photographie de biens immobiliers, utilisez hdr_merge et perspective_correction. Assurez-vous de ne pas utiliser l’outil IA redressement.

École et sport

Pour la photographie scolaire et sportive, utilisez portrait_crop.

Général pour tous les types

Ces outils IA sont bons pour la plupart des types de photographie.

  • crop
  • straighten
  • subject_mask
  • smooth_skin

 

Éditer des photos

1. Créer un projet

Lancez la commande POST https://api-beta.imagen-ai.com/v1/projects/ pour créer un projet.

Nous recommandons de créer un projet pour chaque séance photo. Un projet organise vos photos avec le Profil IA que vous avez choisi pour l’édition de ces photos. La réponse est le project_uuid utilisé pour identifier ce projet. Utilisez ce project_uuid jusqu’à ce que vous exportiez vos photos au format JPEG.

Exemple de réponse

{

    "data": {

        "project_uuid": ""

    }

}

 

2. Obtenir des liens de téléchargement temporaires pour télécharger des photos

Lancez la commande POST https://api-beta.imagen-ai.com/v1/projects//get_temporary_upload_links.

Dans la demande, dans le paramètre files_list, incluez les noms de fichiers des photos à télécharger. Utilisez le format liste.

La réponse comprend un lien temporaire pour chaque photo vers le compartiment S3 d’Imagen sur AWS. Ce lien est l’URL prédéfinie AWS.

Exemple de demande

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”}

    ]

}’

 

Exemple de réponse

{

    "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. Télécharger chaque photo sur son lien de téléchargement temporaire

Téléchargez des photos dans le compartiment S3 d’Imagen sur AWS avec les liens de téléchargement temporaires de la réponse de l’étape précédente. Utilisez la méthode de votre choix.

Pour plus d’informations sur le téléchargement de fichiers avec une URL prédéfinie, consultez ce guide dans la documentation AWS.

Test dans Postman

  • Supprimer Content-Type de l'en-tête.
  • Dans l'onglet Params, ajoutez un nouveau paramètre nommé Content-Type avec une chaîne vide ("") en tant que valeur.

Exigences de l'en-tête de demande

Si vous avez inclus md5 dans le paramètre files_list dans la demande de liens de téléchargement temporaires, assurez-vous d’inclure MD5 dans l’en-tête de la demande pour télécharger les photos. Pour accéder à un exemple de code en Python, consultez api_client.py dans le Projet API Imagen dans Github.

Exigences du corps de la demande

Dans le corps de la demande, ajoutez Content-Type en tant que paramètre de requête avec une chaîne vide ("") en tant que valeur.

4. Commencer l’édition 

Sollicitez POST https://api-beta.imagen-ai.com/v1/projects//edit pour commencer l’édition avec le profil IA que vous avez choisi. 

Dans le corps de la demande, incluez les éléments suivants :

Exemple du corps de la demande

{

  "profile_key": ,

  "hdr_merge": true,

  "photography_type": "NO_TYPE",

  "callback_url": "string",

  "perspective_correction": true

}

La réponse est un message indiquant que le projet a été édité avec succès. En cas d’erreur, envoyez un e-mail à notre équipe du service client.

Clé de profil

La profile_key est un identifiant pour le Profil IA que vous utilisez, permettant d’éditer votre projet. Utilisez un nombre entier. Consultez la réponse dans Choisir un Profil IA pour obtenir votre profile_key.

Outils IA

Un outil IA est un outil de traitement photo supplémentaire, alimenté par l’IA, que vous pouvez ajouter lors de l’édition des photos dans le projet. 

Type de photographie

Le Photography_type indique le type de prise de vue dans le projet. Ce paramètre est facultatif. 

Voici les dofférentes valeurs de photography_type  :

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

Callback URL

Le callback_url est un critère POST qu’Imagen peut utiliser pour envoyer des messages de statut à votre API. Ce paramètre est facultatif. Si vous l’utilisez, vous n’avez pas besoin de vérifier le statut d’édition. Ce critère doit être ouvert à Imagen. 

Les statuts possibles envoyés dans la demande sont :

Exemple de réponse

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



5. Vérifiez le statut d’édition

Sollicitez GET https://api-beta.imagen-ai.com/v1/projects//edit/status pour obtenir le statut actuel du processus d’édition. Continuez à solliciter ce critère par interrogation longue, jusqu’à ce que le statut s’affiche comme Completed.

Si vous souhaitez contourner cette vérification de statut, incluez le callback_url dans la demande /projects//edit/. Consultez URL de rappel pour plus d’informations.

Voici les statuts dans la réponse :

 

6. Obtenez des liens de téléchargement temporaires pour télécharger les photos éditées

Après avoir reçu un statutCOMPLETED, sollicitez la demande GET https://api-beta.imagen-ai.com/v1/projects//edit/get_temporary_download_link. 

Dans la demande, incluez les photos à télécharger dans le paramètre files_list. Utilisez le format liste.

La réponse comprend un lien temporaire pour chaque photo vers le compartiment S3 d’Imagen sur AWS. Ce lien est l’URL prédéfinie AWS.

Exemple de réponse

{

    "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. Télécharger les photos localement

Lorsque Imagen retourne les fichiers édités, les formats respectifs suivants vous sont proposés : 

Format de fichier avant édition Format de fichier renvoyé après édition
RAW XMP
Remarque : lors de l’édition de photos avec HDR Merge, le format renvoyé est toujours DNG, même si le format de fichier avant l’édition était RAW.
DNG DNG avec XMP intégré
JPEG JPEG avec XMP intégré


Téléchargez des photos du compartiment S3 d’Imagen sur AWS avec les liens de téléchargement temporaires de la réponse de l’étape précédente. Utilisez la méthode de votre choix. Pour accéder à un exemple de code en Python, consultez api_client.py dans le projet API Imagen dans Github.

Pour plus d’informations sur le téléchargement de fichiers à partir d’AWS, consultez ce guide dans la documentation AWS.

Exportez les photos pour livraison

L’API Imagen exporte toutes les photos d’un projet au format JPEG. Cette étape est facultative. Certains photographes modifient les éditions et les exportent avec leur logiciel d’édition. Après avoir exporté les photos, vous les livrez ou les téléchargez dans une galerie.

1. Exportez les photos dans le projet

Sollicitez POST https://api-beta.imagen-ai.com/v1/projects//export. La réponse comprend le project_uuid et un message indiquant que l’exportation a réussi. En cas d’erreur, envoyez un e-mail à notre équipe du service client.

2. Vérifiez le statut d’exportation

Sollicitez GET https://api-beta.imagen-ai.com/v1/projects//export/status. La réponse comprend le statut de l’exportation. Les statuts possibles sont :

  • IN PROGRESS : l’API Imagen est en cours d’édition des photos.
  • FAILED: Envoi d’un e-mail à l’équipe du service client.
  • COMPLETED : l’API Imagen a terminé l’exportation des photos au format JPEG. 

3. Télécharger les photos JPEG exportées

Obtenir des liens de téléchargement temporaires pour télécharger des photos JPEG exportées

Une fois le statut d’exportation renvoyé comme COMPLETED, sollicitez GET https://api-beta.imagen-ai.com/v1/projects//export/get_temporary_download_links. 

Dans la demande, incluez les photos exportées dans le paramètre files_list. Utilisez le format liste.

La réponse comprend un lien temporaire pour chaque photo vers le compartiment S3 d’Imagen sur AWS. Ce lien est l’URL prédéfinie AWS.

Exemple de réponse

{

    "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": ""

            }

        ]

    }

}

 

Téléchargez les photos JPEG exportées localement

Téléchargez des photos du compartiment S3 d’Imagen sur AWS avec les liens de téléchargement temporaires de la réponse de l’étape précédente. Utilisez la méthode de votre choix. Pour accéder à un exemple de code en Python, consultez api_client.py dans le Projet API Imagen dans Github.

Pour plus d’informations sur le téléchargement de fichiers à partir d’AWS, consultez ce guide dans la documentation AWS.

Cet article vous a-t-il été utile ?

Vous avez d’autres questions ? Envoyer une demande