Għodda image_generation: Oħloq Immaġnijiet
F'din il-paġna
Iġġenera Immaġnijiet Permezz tal-Aġent Tiegħek
L-għodda image_generation tippermetti lill-aġent tiegħek joħloq immaġnijiet minn deskrizzjonijiet testwali. Din tissupplimenta l-għodod li diġà rajt: filwaqt li code_interpreter tipproduċi numri u grafiċi, din tipproduċi viżwali. Hija għodda qawwija għal każijiet ta’ użu kreattivi, ġenerazzjoni ta’ mockups, jew biex turi kunċetti. Bħal għodod integrati oħra, inti tattivaha meta toħloq l-aġent, u l-mudell jiddeċiedi jekk isejjaħhiex ibbażat fuq it-talba.
Oħloq Aġent bil-Ġenerazzjoni tal-Immaġnijiet
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}
)
L-istruzzjonijiet għandhom piż sinifikanti hawnhekk. Billi titlob lill-aġent biex ifformula mill-ġdid it-talba f’prompt dettaljat, inti ttrasforma “agħmili immaġni ta’ qattus” vaga f’deskrizzjoni azzjonabbli. Billi tagħmlu jħabbar l-immaġni qabel ma jiġġeneraha, inti tagħtik iċ-ċans li tikkoreġi t-triq qabel ma sseħħ il-ġenerazzjoni. Temperatura ta’ 0.3 iżżomm din il-formulazzjoni dixxiplinata: trid preċiżjoni deskrittiva, mhux invenzzjoni libera.
Iġġenera Immaġni
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Generate an image of an orange cat in a modern office."
)
Wara din is-sejħa waħda, l-aġent iħaddem erba’ passi: janalizza t-talba tiegħek, jifformula prompt ottimizzat għall-mudell tal-ġenerazzjoni, joħloq l-immaġni, u mbagħad jirritorna l-fajl. Dawn il-passi jidhru fl-outputs tal-konversazzjoni, u jħalluk tara liema prompt ipproduċa liema immaġni. Dan huwa inestimabbli meta riżultat jogħġbok u trid tirriproduċih.
Niżżel l-Immaġnijiet Iġġenerati
L-immaġnijiet ma jirritornawx bħala test fir-rispons: jaslu bħala oġġetti ToolFileChunk fil-kontenut, u inti tirrikupra l-fajl attwali permezz tal-API tal-Fajls.
from mistralai.client.models import ToolFileChunk
for i, chunk in enumerate(response.outputs[-1].content):
if isinstance(chunk, ToolFileChunk):
# Download the image file
file_bytes = client.files.download(file_id=chunk.file_id).read()
# Save locally
with open(f"image_{i}.png", "wb") as f:
f.write(file_bytes)
print(f"Image saved: image_{i}.png")
Tliet Każijiet ta’ Użu Komuni
L-ewwel huwa l-illustrazzjoni tad-dokumentazzjoni, fejn dijagramma tispjega aħjar minn paragrafu.
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."
)
It-tieni huwa l-mockups viżwali, biex timmaterjalizza direzzjoni qabel ma timpjega ddisinjatur.
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."
)
It-tielet huwa l-ħolqien ta’ kontenut għall-marketing, fejn l-aġent jipproduċi viżwali mfassla apposta minn brief miktub.
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."
)
Fit-tliet każijiet, il-kwalità tal-brief tiddetermina l-kwalità tar-riżultat: aġent kreattiv ma jinventax l-intenzjoni tiegħek, huwa jwettaqha.
Għaqqad ma’ Għodod Oħra
Il-ġenerazzjoni tal-immaġnijiet tilħaq il-potenzjal sħiħ tagħha meta tiġi ppajrata ma’ għodod oħra. It-tfittxija għad-data, l-analiżi tagħha, u mbagħad l-illustrazzjoni tagħha jsiru fluss wieħed mingħajr xkiel mill-perspettiva tal-utent.
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"}
]
)
Ikteb Prompts Tajbin għall-Immaġnijiet
Ħames lievi jtejbu s-soltu r-riżultati b’mod sinifikanti. L-ewwel, kun deskrittiv: “Qattus oranġjo bi strixxi bilqiegħda fuq skrivanija tal-injam, dawl naturali, stil fotografiku” jipproduċi immaġni kompletament differenti minn “qattus”. Imbagħad, speċifika l-istil mistenni—fotografiku, illustrazzjoni, akwarell, minimalistu. Indika l-kompożizzjoni, jiġifieri veduta ta’ quddiem, angolu għoli, close-up, jew wide shot. Semmi d-dawl, kemm jekk naturali, tal-istudjo, controluce, jew sigħat tad-deheb. Fl-aħħar nett, speċifika l-kuluri: paletta sħuna, toni kesħin, monokromu. Dawn il-ħames assi huma eżattament dak li tikteb fl-istruzzjonijiet tal-aġent sabiex ikun jista’ jarrikka talbiet qosra wisq mill-utenti tiegħek.
Immaniġġja l-Fajls Iġġenerati
L-immaġnijiet iġġenerati jinħażnu temporanjament fis-sħab ta’ Mistral permezz tal-API tal-Fajls. Agħmilha drawwa li tagħmel inventarju u tnaddaf: inkella, l-ispazju tiegħek jimtela’ b’abbozzi minsijin, u fajls li kellek bżonn jisparixxu għax ma tniżżlux fil-ħin.
# List files
files = client.files.list()
for f in files.data:
print(f"{f.id} — {f.filename} — {f.bytes} bytes")
# Delete a file
client.files.delete(file_id="file-xxxxxxxx")
Punti Ewlenin
image_generationtoħloq immaġnijiet minn deskrizzjonijiet testwali- L-immaġnijiet jirritornaw bħala oġġetti
ToolFileChunku huma downloadabbli permezz ta’client.files.download() - Prompts dettaljati (stil, kompożizzjoni, dawl) itejbu r-riżultati b’mod sinifikanti
- L-għodda tista’ tiġi kkombinata ma’ web_search u code_interpreter
- Il-fajls iġġenerati huma temporanji—niżżilhom jew se jitħassru