--- title: "API de génération d'images hébergée en Europe · compatible OpenAI" description: "Générez des images à partir de texte avec une API d'images compatible OpenAI. Modèles ouverts comme FLUX.1 schnell, traités dans des centres de l'UE." canonical: "https://inference.eu/fr/api/images/" language: "fr" --- POST /v1/images/generations # API de génération d'images : compatible OpenAI, traitée dans l'UE Le point de terminaison de génération d'images crée des visuels à partir d'une description textuelle grâce à des modèles d'image ouverts. Il suit l'API d'images d'OpenAI : les outils et le code qui appellent \`/v1/images/generations\` fonctionnent après changement de l'URL de base. Les prompts, qui décrivent souvent des produits ou des campagnes encore confidentiels, sont traités dans des centres de données européens. [Contacter l'équipe](https://inference.eu/fr/contact/)[Exemple de requête](#example) 1. 01Format d'API: OpenAI 2. 02Centres de données dans l'UE 3. 03Couvert par un seul DPA POST /v1/images/generations ``` curl https://api.inference.eu/v1/images/generations \ -H "Authorization: Bearer $INFERENCE_EU_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "flux-1-schnell", "prompt": "Product photo of a ceramic coffee mug on a light oak table, soft morning light, plain background", "n": 1, "size": "1024x1024", "response_format": "b64_json" }' | jq -r '.data[0].b64_json' | base64 --decode > mug.png ``` ## Ce que fait le point de terminaison `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é. ## Les champs essentiels de la requête `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. ## Un schéma éprouvé pour les équipes contenu 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. ## Erreurs et cas particuliers 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. ## Image generation Endpoint POST /v1/images/generations Catégorie Endpoints Format d'API OpenAI Base URL api.inference.eu/v1 Traitement Centres de données dans l'UE Entraînement sur vos données Jamais ## Image generation : questions fréquentes Les questions que nous posent le plus les achats, les développeurs et les juristes. Il en manque une ? Posez-la-nous directement. Oui. Le point de terminaison reprend le chemin, les champs (\`model\`, \`prompt\`, \`n\`, \`size\`, \`response\_format\`) et la structure de réponse de l'API de génération d'images d'OpenAI. \`client.images.generate\` fonctionne dans les SDK OpenAI avec l'URL de base et la clé d'inference.eu et un identifiant de modèle ouvert. Le catalogue comprend des modèles d'image ouverts comme FLUX.1 schnell. Appelez \`GET /v1/models\` pour voir ceux accessibles à votre clé, et consultez chaque page modèle pour les tailles et la licence. Si vous avez besoin d'un modèle ouvert précis, demandez-nous et nous vérifierons si nous pouvons l'exploiter. Cela dépend de la licence du modèle, indiquée sur sa page. FLUX.1 schnell est publié sous licence Apache 2.0, qui autorise l'usage commercial. D'autres modèles ont des conditions différentes : vérifiez-les avant publication, et respectez les marques et les droits des personnes dans ce que vous générez. Chaque modèle accepte un ensemble de résolutions, en général des formats carrés comme \`1024x1024\` et des formats paysage ou portrait de nombre de pixels comparable. Passez \`size\` en largeur sur hauteur. Si la taille demandée n'est pas prise en charge, le message d'erreur liste les valeurs acceptées. Choisissez \`b64\_json\` si votre code enregistre ou envoie l'image immédiatement : pas de second téléchargement, et aucune expiration. Choisissez \`url\` pour des réponses légères, à condition de récupérer le fichier rapidement. Les URL de téléchargement sont temporaires et ne doivent pas servir de lien permanent. Cette page traite de la génération d'images à partir de texte. La retouche d'une image existante dépend des modèles accessibles à votre clé ; dites-nous ce dont vous avez besoin, par exemple remplacer un arrière-plan ou compléter une zone, et nous vous indiquerons les modèles et requêtes adaptés. Non. Les prompts sont traités dans des centres de données de l'UE pour générer les images et ne servent pas à entraîner des modèles. Les images renvoyées en \`b64\_json\` n'existent que dans la réponse ; celles fournies par \`url\` ne sont conservées que le temps de leur téléchargement. Les modèles d'image dessinent le texte comme des formes et se trompent souvent, surtout sur des phrases longues. Demandez une image sans texte et ajoutez titres, prix et logos ensuite dans votre outil de création. Un mot court passe mieux qu'une phrase, mais vérifiez-le avant publication. [Poser une question](https://inference.eu/fr/contact/) ## Pages liées [Présentation de l'API](https://inference.eu/fr/api/) - [VisionEnvoyez des images à des modèles de vision ouverts au format chat d'OpenAI. Tickets, captures d'écran, formulaires et photos, traités dans l'UE.Guides](https://inference.eu/fr/api/vision/) - [Chat completionsEnvoyez vos messages à des modèles open-weight au format chat completions d'OpenAI. Traitement dans des centres de données de l'UE, sans entraînement.Endpoints](https://inference.eu/fr/api/chat-completions/) - [List modelsListez avec GET /v1/models, au format OpenAI, tous les modèles open-weight accessibles à votre clé inference.eu, du chat aux embeddings et à la voix.Endpoints](https://inference.eu/fr/api/models/) ## Faites passer vos charges IA sur une infrastructure européenne Dites-nous quels modèles vous utilisez et votre volume approximatif. Nous répondons sous un jour ouvré avec un tarif et la suite. - Réponse sous un jour ouvré - Tarif adapté à votre volume - DPA prêt à signer