Tool image_generation : générer des images
Op deze pagina
Générer des images via votre agent
L’outil image_generation permet à votre agent de créer des images à partir de descriptions textuelles. Il complète les outils que vous avez déjà découverts : tandis que code_interpreter produit des nombres et des graphiques, celui-ci génère des visuels. C’est un outil puissant pour des cas d’usage créatifs, la génération de maquettes ou l’illustration de concepts. Comme les autres outils intégrés, vous l’activez lors de la création de l’agent, et le modèle décide de l’appeler ou non en fonction de la demande.
Créer un agent avec génération d’images
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Creative Agent",
instructions="""You are a creative assistant specialized in image generation.
- Rephrase requests into detailed prompts for better results
- Describe the image you are about to generate before creating it
- Propose variations if the result is unsatisfactory""",
tools=[{"type": "image_generation"}],
completion_args={"temperature": 0.3, "top_p": 0.95}
)
Les instructions ont ici une importance capitale. En demandant à l’agent de reformuler la demande en un prompt détaillé, vous transformez une requête vague comme « fais-moi une image de chat » en une description exploitable. En lui faisant décrire l’image avant de la générer, vous vous donnez la possibilité de corriger le tir avant la génération proprement dite. Une température de 0,3 maintient cette reformulation disciplinée : vous recherchez la précision descriptive, pas l’invention libre.
Générer une image
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Generate an image of an orange cat in a modern office."
)
Derrière cet unique appel, l’agent enchaîne quatre étapes : il analyse votre demande, formule un prompt optimisé pour le modèle de génération, crée l’image, puis renvoie le fichier. Ces étapes apparaissent dans les sorties de la conversation, vous permettant de voir quel prompt a produit quelle image. Cela s’avère indispensable lorsqu’un résultat vous satisfait et que vous souhaitez le reproduire.
Télécharger les images générées
Les images ne sont pas renvoyées sous forme de texte dans la réponse : elles arrivent sous forme d’objets ToolFileChunk dans le contenu, et vous récupérez le fichier réel via l’API Files.
from mistralai.client.models import ToolFileChunk
for i, chunk in enumerate(response.outputs[-1].content):
if isinstance(chunk, ToolFileChunk):
# Télécharger le fichier image
file_bytes = client.files.download(file_id=chunk.file_id).read()
# Enregistrer localement
with open(f"image_{i}.png", "wb") as f:
f.write(file_bytes)
print(f"Image saved: image_{i}.png")
Trois cas d’usage courants
Le premier est l’illustration de documentation, où un diagramme explique mieux qu’un paragraphe.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Create a visual diagram showing a microservices architecture with an API Gateway, 3 services, and a database."
)
Le deuxième concerne les maquettes visuelles, pour matérialiser une direction avant de faire appel à un designer.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Generate a homepage mockup for an online learning website, modern and minimalist style with blue tones."
)
Le troisième est la création de contenu marketing, où l’agent produit un visuel sur mesure à partir d’un brief écrit.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Create a promotional banner for an AI course, with the text 'Master AI in 2026' on a tech background."
)
Dans ces trois cas, la qualité du brief détermine la qualité du résultat : un agent créatif n’invente pas votre intention, il l’exécute.
Combiner avec d’autres outils
La génération d’images atteint son plein potentiel lorsqu’elle est associée à d’autres outils. Rechercher des données, les analyser, puis les illustrer devient un flux unique et fluide du point de vue de l’utilisateur.
agent = client.beta.agents.create(
model="mistral-large-latest",
name="Multimodal Agent",
description="Search, code, and images.",
instructions="Use search to find data, code to analyze it, and image generation to illustrate it.",
tools=[
{"type": "web_search"},
{"type": "code_interpreter"},
{"type": "image_generation"}
]
)
Rédiger de bons prompts d’image
Cinq leviers améliorent significativement les résultats. Premièrement, soyez descriptif : « Un chat orange rayé assis sur un bureau en bois, éclairage naturel, style photographique » produit une image totalement différente de « un chat ». Ensuite, précisez le style attendu : photographique, illustration, aquarelle, minimaliste. Indiquez la composition, c’est-à-dire vue de face, plongée, gros plan ou plan large. Mentionnez l’éclairage, qu’il soit naturel, studio, à contre-jour ou heure dorée. Enfin, spécifiez les couleurs : palette chaude, tons froids, monochrome. Ces cinq axes sont exactement ce que vous devez inscrire dans les instructions de l’agent afin qu’il puisse enrichir les requêtes trop succinctes de vos utilisateurs.
Gérer les fichiers générés
Les images générées sont stockées temporairement dans le cloud Mistral via l’API Files. Prenez l’habitude de les inventorier et de les nettoyer : sinon, votre espace se remplira de brouillons oubliés, et les fichiers dont vous aviez besoin disparaîtront parce qu’ils n’ont pas été téléchargés à temps.
# Lister les fichiers
files = client.files.list()
for f in files.data:
print(f"{f.id} — {f.filename} — {f.bytes} bytes")
# Supprimer un fichier
client.files.delete(file_id="file-xxxxxxxx")
Belangrijkste punten
image_generationcrée des images à partir de descriptions textuelles- Les images sont renvoyées sous forme d’objets
ToolFileChunket sont téléchargeables viaclient.files.download() - Des prompts détaillés (style, composition, éclairage) améliorent considérablement les résultats
- L’outil peut être combiné avec web_search et code_interpreter
- Les fichiers générés sont temporaires : téléchargez-les, sinon ils seront supprimés