Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Muokkaus useassa vuorovaikutuksessa ja kohdennettu jälkikäsittely

Oppitunti 8 / 14 Päivitetty 3. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Muokkausten ketjuttaminen
  2. Alueen kohdistaminen kehotteen avulla
  3. Alueen suojaaminen pikselitarkasti: paikallinen maski
  4. Täydellinen muokkausputki
  5. Keskeiset asiat

Päivitetty 3. marraskuuta 2026. Perustuen Image Editing -sivuun, Image Prompting Guide -oppaaseen ja xAI Images API -viitteeseen: /v1/images/edits-päätepisteessä ei ole mask-parametria – ei viitteessä eikä xai-sdk versiossa 1.21.0 – toisin kuin edellinen versio väitti. Jälkikäsittely kohdistetaan kehotteen avulla, ja alue suojataan pikselitarkasti paikallisesti muokkaamisen jälkeen sovelletulla maskilla. Lähteet: Image Editing · Image Prompting Guide · Images API.

Muokkausten ketjuttaminen

Kuvien muokkaus muuttuu todella tehokkaaksi, kun ketjutat useita muunnoksia. xAI:n kuvaama periaate on yksinkertainen: yhden muokkauksen tulosteesta tulee seuraavan syöte, jolloin voit lähteä liikkeelle peruskuvasta ja lisätä yksityiskohtia, säätää tyyliä tai korjata asioita vuorovaikutus kierros kerrallaan.

import requests
import os

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

def edit_image(image_url, prompt):
    """Muokkaa kuvaa ja palauttaa tuloksen URL-osoitteen."""
    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"]

# Kierros 1: muuta taustaa
url_tour1 = edit_image(
    "https://exemple.com/portrait.jpg",
    "Replace the background with a modern office overlooking the city. "
    "Keep the same person, pose, and framing."
)

# Kierros 2: säädä valaistusta
url_tour2 = edit_image(
    url_tour1,
    "Make the light warm and dim, like late afternoon. "
    "Keep the same person, decor, and framing."
)

# Kierros 3: lisää elementti
url_tour3 = edit_image(
    url_tour2,
    "Place an open laptop on the desk, in front of the person. "
    "Keep the same person, lighting, and framing."
)

print(f"Final result: {url_tour3}")

Parhaat käytännöt usean kierroksen muokkaukseen

xAI:n opas neuvoo muokkaamaan silloin, kun kohde ja asettelu ovat jo hyviä ja vain yhdestä kolmeen yksityiskohtaa tarvitsee muuttaa; jos itse kohde on väärä, on parempi luoda kuva uudelleen. Jokainen kierros aloittaa muunnoksella ja toteaa sitten yhdellä lauseella, mikä ei liiku: kohde, kulma, rajaus tai esineiden sijoittelu. Oppaan mukaan kaksi formulointia epäonnistuu: sellainen, joka alkaa sanoilla “pidä kaikki ennallaan”, mikä ei muuta melkein mitään, ja sellainen, joka kopioi koko kehotteen, mikä sommittelee kohtauksen uudelleen – kohde vääristyy, esine monistuu tai se muuttuu viereiseksi esineeksi.

Järjestä kierrokset yleisestä tarkkaan: ensin tausta, sommittelu ja tunnelma, sitten asusteet ja hienosäädöt, jotta myöhäinen suuri muutos ei kumoa pieniä jälkikäsittelyjä.

Kaksi varotoimenpidettä täydentää menetelmän. Lataa jokainen välitulos heti sen valmistuttua: URL-osoitteet ovat väliaikaisia, ja viiden kierroksen sarjan kolmannen kierroksen menettäminen pakottaa sinut aloittamaan uudelleen toisesta kierroksesta. Tarkasta myös jokainen vaihe ennen ketjutusta: ensimmäisellä kierroksella syntynyt virhe – vääristynyt sormi tai epäjohdonmukainen varjo – päätyy kaikkiin myöhempiin kierroksiin, sillä jokainen niistä alkaa edellisestä kuvasta.

Alueen kohdistaminen kehotteen avulla

API ei hyväksy maskia: kohdistus tapahtuu kehotteella. Nimeä muokattava osa mahdollisimman tarkasti – nimen, sijainnin tai materiaalin perusteella – ja nimeä se, mitä täytyy pitää identtisenä.

url_chapeau = edit_image(
    url_tour3,
    "Replace the person's cap with a wide-brimmed straw hat. "
    "Keep the same face, hairstyle, decor, and framing."
)

Kun korjaus ei tartu, opas suosittelee sanamuotojen vaihtamista saman pyynnön toistamisen sijaan; nimeä kuvan se osa, jota korjataan, ja mitä sen pitäisi esittää. Useiden kuvien yhdistämiseen – esimerkiksi tuote sisustuksessa tai hahmo yhdestä kuvasta toiseen – muokkaus hyväksyy jopa viisi lähdekuvaa (katso oppitunti 7).

Alueen suojaaminen pikselitarkasti: paikallinen maski

Jos kuvan osan ei saa liikkua edes pikseliä – kuten logo, kasvot tai teksti – levitä maski paikallisesti muokkaamisen jälkeen: säilytät alkuperäisen alueen ja otat muokatusta kuvasta vain sen, mikä jää tämän alueen ulkopuolelle. Pillow-kirjastolla Image.composite(image1, image2, mask) kopioi image1:n sieltä, missä maski on valkoinen, ja pitää image2:n siellä, missä se on musta:

from PIL import Image, ImageDraw

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

# Maski: valkoinen = ota muokattu, musta = pidä alkuperäinen
masque = Image.new("L", original.size, 255)
draw = ImageDraw.Draw(masque)
draw.rectangle([40, 40, 360, 160], fill=0)  # suojattu alue, esim. logo

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

Kolmen kuvan on oltava saman kokoisia. Koon muuttaminen olettaa, että muokkaus on säilyttänyt lähteen kuvasuhteen: tarkista tämä tai pakota se pyynnön aspect_ratio-parametrilla. Maski ei estä mallia koskettamasta aluetta; se mahdollistaa alueen palauttamisen jälkeenpäin.

Täydellinen muokkausputki

Tässä on esimerkki jäsennellystä putkesta, joka säilyttää historian jokaiselta kierrokselta:

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

Keskeiset asiat

  • Usean kierroksen muokkaus ketjuttaa tuloksia: jokainen tuloste on seuraavan muokkauksen syöte
  • Muokkaa, kun kohde ja asettelu ovat hyviä ja vain yhdestä kolmeen yksityiskohtaa tarvitsee muuttaa
  • Jokaisella kierroksella: ensin muunnos, sitten se, mitä täytyy pitää identtisenä
  • API:ssa ei ole mask-parametria: kohdista kehotteella ja suojaa alue paikallisella maskilla, jota sovelletaan muokkaamisen jälkeen
  • Tulosteiden URL-osoitteet ovat väliaikaisia: lataa välitulokset