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

Modificări în mai multe etape și retușare țintită

Lecția 8 din 14 Actualizată 3 noiembrie 2026 Începător
Pe această pagină
  1. Înlănțuirea editărilor
  2. Țintirea unei zone prin prompt
  3. Protejarea unei zone la nivel de pixel: Masca locală
  4. Flux complet de editare
  5. Puncte cheie

Actualizat la 3 noiembrie 2026. Pe baza paginii Image Editing, a ghidului Image Prompting Guide și a referinței API xAI Images: endpoint-ul /v1/images/edits nu are niciun parametru mask—nici în documentație, nici în xai-sdk 1.21.0—contrar afirmațiilor din versiunea anterioară. Retușarea se face țintit prin prompt, iar o zonă este protejată la nivel de pixel printr-o mască aplicată local, după editare. Surse: Image Editing · Image Prompting Guide · Images API.

Înlănțuirea editărilor

Editarea imaginilor devine cu adevărat puternică atunci când înlănțuiți mai multe modificări. Principiul, descris de xAI, este simplu: rezultatul unei editări devine intrarea pentru următoarea, permițându-vă să porniți de la o imagine de bază și să adăugați detalii, să ajustați stilul sau să corectați elemente, pas cu pas.

import requests
import os

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

def edit_image(image_url, prompt):
    """Editează o imagine și returnează URL-ul rezultatului."""
    response = requests.post(
        "https://api.x.ai/v1/images/edits",
        headers=headers,
        json={
            "model": "grok-imagine-image",
            "prompt": prompt,
            "image": {"url": image_url}
        }
    )
    response.raise_for_status()
    return response.json()["data"][0]["url"]

# Etapa 1: modificarea fundalului
url_tour1 = edit_image(
    "https://exemple.com/portrait.jpg",
    "Înlocuiește fundalul cu un birou modern cu vedere spre oraș. "
    "Păstrează aceeași persoană, poziție și încadrare."
)

# Etapa 2: ajustarea luminii
url_tour2 = edit_image(
    url_tour1,
    "Fă lumina caldă și difuză, ca la sfârșitul după-amiezii. "
    "Păstrează aceeași persoană, decor și încadrare."
)

# Etapa 3: adăugarea unui element
url_tour3 = edit_image(
    url_tour2,
    "Plasează un laptop deschis pe birou, în fața persoanei. "
    "Păstrează aceeași persoană, iluminare și încadrare."
)

print(f"Rezultat final: {url_tour3}")

Cele mai bune practici pentru editarea în mai multe etape

Ghidul xAI recomandă editarea atunci când subiectul și compoziția sunt deja bune și trebuie modificate doar unul până la trei detalii; dacă subiectul în sine este greșit, este mai bine să regenerați imaginea. Fiecare etapă începe cu descrierea modificării, urmată de o propoziție care specifică ce nu se schimbă: subiectul, unghiul, încadrarea sau poziționarea obiectelor. Conform ghidului, două formulări eșuează: una care începe cu „păstrează totul“, care nu schimbă aproape nimic, și una care copiază un prompt complet, ceea ce recompozează scena—subiectul se modifică, un obiect se dublează sau se transformă într-un obiect vecin.

Ordonati etapele de la general la specific: mai întâi fundalul, compoziția și atmosfera, apoi accesoriile și corecțiile fine, astfel încât o modificare majoră târzie să nu anuleze retușurile mici anterioare.

Două măsuri de siguranță completează metoda. Descărcați fiecare rezultat intermediar imediat ce este produs: URL-urile sunt temporare, iar pierderea etapei 3 dintr-o serie de cinci vă obligă să reporniți de la etapa 2. De asemenea, inspectați fiecare pas înainte de a continua: un defect introdus la etapa 1—un deget distorsionat, o umbră inconsistentă—se va regăsi în toate etapele ulterioare, deoarece fiecare pornește de la imaginea precedentă.

Țintirea unei zone prin prompt

API-ul nu acceptă nicio mască: promptul este cel care țintește. Designați partea de modificat cât mai precis posibil—prin nume, poziție, material—și specificați ce trebuie să rămână identic.

url_chapeau = edit_image(
    url_tour3,
    "Înlocuiește șapca persoanei cu o pălărie de paie cu boruri largi. "
    "Păstrează aceeași față, coafură, decor și încadrare."
)

Atunci când o corecție nu funcționează, ghidul recomandă schimbarea cuvintelor în loc să repetați aceeași cerere, desemnând partea imaginii de corectat și ce ar trebui să afișeze aceasta. Pentru a asambla mai multe imagini—un produs într-un decor, un personaj dintr-o imagine în alta—editarea acceptă până la cinci imagini sursă (lecția 7).

Protejarea unei zone la nivel de pixel: Masca locală

Dacă o parte a imaginii nu trebuie să se miște nici măcar un pixel—un logo, o față, text—aplicați masca local, după editare: păstrați zona originală și preluați din imaginea editată doar ceea ce se află în afara acestei zone. Cu Pillow, Image.composite(image1, image2, mask) copiază image1 acolo unde masca este albă și păstrează image2 acolo unde este neagră:

from PIL import Image, ImageDraw

original = Image.open("original.jpg").convert("RGB")
edite = Image.open("edite.jpg").convert("RGB").resize(original.size)

# Mască: alb = preia editarea, negru = păstrează originalul
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0)  # zonă protejată, de ex. un logo

resultat = Image.composite(edite, original, masque)
resultat.save("resultat.jpg")

Cele trei imagini trebuie să aibă aceeași dimensiune. Redimensionarea presupune că editarea a păstrat raportul de aspect al sursei: verificați acest lucru sau impuneți-l prin parametrul aspect_ratio al cererii. Masca nu împiedică modelul să atingă zona; ea vă permite să o restaurați ulterior.

Flux complet de editare

Iată un exemplu de flux structurat, care păstrează istoricul fiecărei etape:

class ImageEditor:
    def __init__(self, api_key):
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
        self.history = []

    def edit(self, image_url, prompt):
        response = requests.post(
            "https://api.x.ai/v1/images/edits",
            headers=self.headers,
            json={
                "model": "grok-imagine-image",
                "prompt": prompt,
                "image": {"url": image_url}
            }
        )
        response.raise_for_status()

        result_url = response.json()["data"][0]["url"]
        self.history.append({
            "prompt": prompt,
            "input": image_url,
            "output": result_url
        })
        return result_url

Puncte cheie

  • Editarea în mai multe etape înlănțuie rezultatele: fiecare ieșire devine intrarea pentru următoarea editare
  • Editați atunci când subiectul și compoziția sunt bune și trebuie modificate doar unul până la trei detalii
  • Fiecare etapă: mai întâi modificarea, apoi ce trebuie să rămână identic
  • API-ul nu are parametrul mask: țintiți prin prompt și protejați o zonă cu o mască locală aplicată după editare
  • URL-urile de ieșire sunt temporare: descărcați rezultatele intermediare