Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Għodda image_generation: Oħloq Immaġnijiet

Lezzjoni 10 / 18 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Iġġenera Immaġnijiet Permezz tal-Aġent Tiegħek
  2. Oħloq Aġent bil-Ġenerazzjoni tal-Immaġnijiet
  3. Iġġenera Immaġni
  4. Niżżel l-Immaġnijiet Iġġenerati
  5. Tliet Każijiet ta’ Użu Komuni
  6. Għaqqad ma’ Għodod Oħra
  7. Ikteb Prompts Tajbin għall-Immaġnijiet
  8. Immaniġġja l-Fajls Iġġenerati
  9. Punti Ewlenin

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_generation toħloq immaġnijiet minn deskrizzjonijiet testwali
  • L-immaġnijiet jirritornaw bħala oġġetti ToolFileChunk u 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