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

Editarea și referințarea mai multor imagini

Lecția 7 din 14 Actualizată 2 noiembrie 2026 Începător
Pe această pagină
  1. Lucrul cu mai multe imagini sursă
  2. Parametrul images (la plural)
  3. Referențierea imaginilor în prompt
  4. Cazuri de utilizare cu mai multe imagini
  5. Limite și bune practici
  6. Exercițiu practic
  7. Puncte cheie

Actualizat pe 2 noiembrie 2026 — Imagine. grok-imagine-image-quality a fost eliminat începând cu 2 noiembrie 2026 (cererile sunt acum gestionate de Imagine 2.0 în calitate low): exemplele folosesc acum grok-imagine-image (Imagine 1.0) și grok-imagine-image-2.0 (Imagine 2.0, calitate low, medium sau auto). Cu SDK-ul OpenAI, aspect_ratio, resolution și quality se transmit prin extra_body, iar editarea se gestionează prin SDK-ul xAI sau o cerere HTTP.

Lucrul cu mai multe imagini sursă

Unul dintre punctele forte ale endpoint-ului de editare este capacitatea de a furniza până la 5 imagini de referință într-o singură cerere. Acest lucru deschide posibilități creative avansate: combinarea elementelor din mai multe surse, fuzionarea stilurilor sau crearea unor compoziții complexe.

Parametrul images (la plural)

Trecerea de la image la images schimbă mai mult decât forma parametrului: schimbă ceea ce cereți modelului să facă. Cu o singură sursă, acesta modifică o imagine; cu mai multe, trebuie să arbitreze între ele — decidând ce să preia din fiecare. Va arbitra indiferent de situație; singura întrebare este dacă direcționați acest proces, aspect care face obiectul secțiunii următoare.

Rețineți că cei doi parametri se exclud reciproc: image (obiect unic) și images (tablou) nu pot fi combinate.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

payload = {
    "model": "grok-imagine-image",
    "prompt": "Combină personajul din prima imagine cu "
              "peisajul din a doua imagine",
    "images": [
        {"url": "https://exemple.com/personnage.jpg"},
        {"url": "https://exemple.com/paysage.jpg"}
    ]
}

response = requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
).json()

Referențierea imaginilor în prompt

Atunci când furnizați mai multe imagini, le puteți referenția individual în prompt folosind sintaxa <IMAGE_0>, <IMAGE_1> etc. Indexarea începe de la 0.

payload = {
    "model": "grok-imagine-image",
    "prompt": "Plasează produsul din <IMAGE_0> pe masa din <IMAGE_1>, "
              "cu iluminarea ambientală din <IMAGE_2>",
    "images": [
        {"url": "https://exemple.com/produit.jpg"},      # <IMAGE_0>
        {"url": "https://exemple.com/table.jpg"},         # <IMAGE_1>
        {"url": "https://exemple.com/ambiance.jpg"}       # <IMAGE_2>
    ]
}

Această sintaxă este ceea ce distinge o compoziție controlată de o fuziune aproximativă. „Combină aceste imagini“ lasă totul la latitudinea modelului; „plasează produsul din <IMAGE_0> în decorul din <IMAGE_1> păstrând iluminarea din <IMAGE_1>“ nu lasă loc de interpretare. De îndată ce furnizați mai mult de o sursă, referențiați-le explicit.

Cazuri de utilizare cu mai multe imagini

Transfer de stil

Aplicați stilul unei imagini de referință asupra alteia:

payload = {
    "model": "grok-imagine-image-2.0",
    "prompt": "Reproduce conținutul din <IMAGE_0> în stilul artistic al <IMAGE_1>",
    "images": [
        {"url": "https://exemple.com/photo-originale.jpg"},
        {"url": "https://exemple.com/reference-style.jpg"}
    ]
}

Compoziție de produs

Integrați un produs într-un decor cu o iluminare de referință:

payload = {
    "model": "grok-imagine-image-2.0",
    "prompt": "Fotografiați produsul din <IMAGE_0> așezat pe mobila din <IMAGE_1> "
              "în camera din <IMAGE_2>, cu o iluminare naturală consistentă",
    "images": [
        {"url": "https://exemple.com/produit-detouré.png"},
        {"url": "https://exemple.com/meuble.jpg"},
        {"url": "https://exemple.com/piece.jpg"}
    ]
}

Fuziune față și fundal

Combinați un portret cu un fundal specific:

payload = {
    "model": "grok-imagine-image",
    "prompt": "Plasează persoana din <IMAGE_0> în fața clădirii din <IMAGE_1>, "
              "păstrând iluminarea naturală și perspectiva",
    "images": [
        {"url": "https://exemple.com/portrait.jpg"},
        {"url": "https://exemple.com/batiment.jpg"}
    ]
}

Limite și bune practici

Limita tehnică este de 5 imagini per cerere, iar puteți amesteca liber formatele — unele surse ca URL-uri, altele ca Base64 — în același tablou. Dificultatea reală nu stă aici: ea rezidă în precizia promptului, care trebuie să crească odată cu numărul de imagini. Cu două surse, „combină personajul și decorul“ adesea este suficient; cu cinci, modelul nu mai poate ghici ce element să preia din care imagine, iar aici intervine rolul referințelor <IMAGE_1> până la <IMAGE_5>: „plasează logo-ul din <IMAGE_2> pe tricoul personajului din <IMAGE_1>, în ambianța luminoasă din <IMAGE_3>“ nu lasă nicio ambiguitate. Pentru compoziții complexe cu mai multe surse, modelul pro (grok-imagine-image-quality) își justifică costul suplimentar: aici se observă cel mai clar diferența față de modelul standard, în consistența dintre elementele heterogene.

Exercițiu practic

Încercați să combinați două imagini pe care le aveți la dispoziție:

payload = {
    "model": "grok-imagine-image",
    "prompt": "Creează o scenă în care obiectul din <IMAGE_0> plutește pe cerul din <IMAGE_1>, "
              "în stil suprarealist",
    "images": [
        {"url": "URL_OF_YOUR_FIRST_IMAGE"},
        {"url": "URL_OF_YOUR_SECOND_IMAGE"}
    ],
    "n": 3
}

Generați 3 variații pentru a compara interpretările modelului.

Puncte cheie

  • Parametrul images acceptă până la 5 imagini sursă într-un tablou
  • image (singular) și images (plural) se exclud reciproc
  • Sintaxa <IMAGE_0>, <IMAGE_1> vă permite să referențiați fiecare imagine în prompt
  • Cazurile de utilizare includ transferul de stil, compoziția și fuziunea
  • Fiți preciși în prompt atunci când utilizați mai multe surse