API de génération d'images : compatible OpenAI, traitée dans l'UE

POST /v1/images/generations reçoit un model et un prompt, et renvoie une ou plusieurs images. La réponse comporte un horodatage created et un tableau data ; chaque élément contient soit b64_json, l'image encodée en base64, soit une url de téléchargement, selon response_format.

Des modèles ouverts comme FLUX.1 schnell, du laboratoire allemand Black Forest Labs, donnent de bons résultats en peu d'étapes, ce qui convient aux brouillons, illustrations et maquettes de produits. Chaque page modèle précise les tailles, la licence et les points forts des modèles d'image que nous exploitons, et GET /v1/models indique ceux accessibles à votre clé.

prompt décrit l'image. Les descriptions concrètes fonctionnent le mieux : sujet, décor, lumière, style et composition, dans cet ordre, plutôt qu'une liste d'adjectifs. n fixe le nombre d'images par requête et size la résolution en largeur sur hauteur, par exemple 1024x1024 ou 1344x768, parmi les tailles prises en charge par le modèle.

response_format vaut b64_json ou url. Le base64 est le plus simple si vous enregistrez l'image tout de suite, comme dans l'exemple. Une URL allège la réponse mais expire vite : téléchargez le fichier sans tarder. Les champs propres aux modèles d'image d'OpenAI, comme leurs réglages de qualité et de style, sont ignorés.

Une organisation fréquente consiste à confier la rédaction du prompt à un modèle de chat. Donnez-lui l'article, la fiche produit ou le brief de campagne et demandez un prompt qui suit une structure fixe et la charte visuelle de votre marque, puis envoyez-le au point de terminaison d'images. Générez trois ou quatre variantes avec n et laissez une personne choisir.

Conservez le prompt et le modèle de chaque image publiée pour pouvoir la recréer ou l'ajuster. Pour un grand catalogue, une illustration par produit par exemple, lancez les requêtes depuis une file d'attente avec reprises plutôt que depuis une page où l'utilisateur patiente.

Une size non prise en charge renvoie une erreur 400 qui liste les tailles acceptées par le modèle. Les prompts qui demandent un contenu manifestement illégal sont refusés par une erreur. La génération d'images est plus lourde que celle de texte : comptez quelques secondes par requête, prévoyez un délai d'attente généreux côté client et réessayez les 429 et 5xx avec un délai croissant.

Les modèles d'image peinent avec le texte exact, les quantités précises et la ressemblance avec des personnes réelles. Ajoutez textes et logos ensuite dans votre outil de création. Vérifiez la licence du modèle avant tout usage commercial et signalez les images générées lorsque la loi ou votre politique le demande.