Editarea și referințarea mai multor imagini
Pe această pagină
Actualizat pe 2 noiembrie 2026 — Imagine.
grok-imagine-image-qualitya fost eliminat începând cu 2 noiembrie 2026 (cererile sunt acum gestionate de Imagine 2.0 în calitatelow): exemplele folosesc acumgrok-imagine-image(Imagine 1.0) șigrok-imagine-image-2.0(Imagine 2.0, calitatelow,mediumsauauto). Cu SDK-ul OpenAI,aspect_ratio,resolutionșiqualityse transmit prinextra_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
imagesacceptă până la 5 imagini sursă într-un tablou image(singular) șiimages(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