Salt la conținutul principal
Română— Alege o limbă
Meniu

Instrumentul image_generation: Crearea de imagini

Lecția 10 din 18 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Generarea de imagini prin intermediul agentului dumneavoastră
  2. Crearea unui agent cu generare de imagini
  3. Generarea unei imagini
  4. Descărcarea imaginilor generate
  5. Trei cazuri de utilizare frecvente
  6. Combinarea cu alte instrumente
  7. Scrierea unor prompturi de imagine eficiente
  8. Gestionarea fișierelor generate
  9. Puncte cheie

Generarea de imagini prin intermediul agentului dumneavoastră

Instrumentul image_generation permite agentului dumneavoastră să creeze imagini pe baza descrierilor textuale. Acesta completează instrumentele pe care le-ați văzut deja: în timp ce code_interpreter produce numere și grafice, acesta generează elemente vizuale. Este un instrument puternic pentru cazuri de utilizare creative, generarea de machete sau ilustrarea conceptelor. La fel ca celelalte instrumente integrate, îl activați la crearea agentului, iar modelul decide dacă să îl apeleze în funcție de solicitare.

Crearea unui agent cu generare de imagini

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}
)

Instrucțiunile au o importanță majoră aici. Prin solicitarea ca agentul să reformuleze cererea într-un prompt detaliat, transformați un „fă-mi o imagine cu o pisică“ vag într-o descriere executabilă. Făcându-l să anunțe imaginea înainte de a o genera, vă oferiți șansa de a corecta direcția înainte ca generarea să aibă loc. O temperatură de 0.3 menține această reformulare disciplinată: doriți precizie descriptivă, nu invenție liberă.

Generarea unei imagini

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Generate an image of an orange cat in a modern office."
)

În spatele acestui singur apel, agentul înlănțuie patru pași: analizează solicitarea dumneavoastră, formulează un prompt optimizat pentru modelul de generare, creează imaginea și returnează apoi fișierul. Acești pași apar în ieșirile conversației, permițându-vă să vedeți care prompt a produs care imagine. Acest lucru este inestimabil atunci când un rezultat vă satisface și doriți să îl reproduceți.

Descărcarea imaginilor generate

Imaginile nu sunt returnate ca text în răspuns: ele sosesc sub formă de obiecte ToolFileChunk în conținut, iar dumneavoastră recuperați fișierul actual prin intermediul API-ului Files.

from mistralai.client.models import ToolFileChunk

for i, chunk in enumerate(response.outputs[-1].content):
    if isinstance(chunk, ToolFileChunk):
        # Descărcați fișierul imagine
        file_bytes = client.files.download(file_id=chunk.file_id).read()

        # Salvați local
        with open(f"image_{i}.png", "wb") as f:
            f.write(file_bytes)
        print(f"Image saved: image_{i}.png")

Trei cazuri de utilizare frecvente

Primul este ilustrarea documentației, unde o diagramă explică mai bine decât un paragraf.

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."
)

Al doilea este realizarea de machete vizuale, pentru a materializa o direcție înainte de a angaja 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."
)

Al treilea este crearea de conținut de marketing, unde agentul produce un vizual adaptat pe baza unui brief scris.

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."
)

În toate cele trei cazuri, calitatea briefului determină calitatea rezultatului: un agent creativ nu inventează intenția dumneavoastră, ci o execută.

Combinarea cu alte instrumente

Generarea de imagini își atinge potențialul maxim atunci când este asociată cu alte instrumente. Căutarea datelor, analizarea lor și apoi ilustrarea acestora devine un flux unic și fluid din perspectiva utilizatorului.

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"}
    ]
)

Scrierea unor prompturi de imagine eficiente

Cinci pârghii îmbunătățesc semnificativ rezultatele. În primul rând, fiți descriptiv: „O pisică portocalie cu dungi stând pe un birou din lemn, lumină naturală, stil fotografic“ produce o imagine complet diferită față de „o pisică“. Apoi, specificați stilul așteptat—fotografic, ilustrație, acuarelă, minimalist. Indicați compoziția, adică vedere din față, unghi ridicat, prim-plan sau plan larg. Menționați iluminarea, fie naturală, de studio, contra-lumină sau „golden hour“. În final, specificați culorile: paletă caldă, tonuri reci, monocrom. Aceste cinci axe sunt exact ceea ce scrieți în instrucțiunile agentului, astfel încât acesta să poată îmbogăți solicitările prea scurte ale utilizatorilor dumneavoastră.

Gestionarea fișierelor generate

Imaginile generate sunt stocate temporar în cloud-ul Mistral prin intermediul API-ului Files. Obișnuiți-vă să faceți inventarul și curățenia: altfel, spațiul dumneavoastră se va umple de ciorne uitate, iar fișierele de care aveați nevoie vor dispărea pentru că nu au fost descărcate la timp.

# Listarea fișierelor
files = client.files.list()
for f in files.data:
    print(f"{f.id} — {f.filename} — {f.bytes} bytes")

# Ștergerea unui fișier
client.files.delete(file_id="file-xxxxxxxx")

Puncte cheie

  • image_generation creează imagini din descrieri textuale
  • Imaginile sunt returnate ca obiecte ToolFileChunk și pot fi descărcate prin client.files.download()
  • Prompturile detaliate (stil, compoziție, iluminare) îmbunătățesc semnificativ rezultatele
  • Instrumentul poate fi combinat cu web_search și code_interpreter
  • Fișierele generate sunt temporare—descărcați-le sau vor fi șterse