Muokkaus useassa vuorovaikutuksessa ja kohdennettu jälkikäsittely
Tällä sivulla
Päivitetty 3. marraskuuta 2026. Perustuen Image Editing -sivuun, Image Prompting Guide -oppaaseen ja xAI Images API -viitteeseen:
/v1/images/edits-päätepisteessä ei olemask-parametria – ei viitteessä eikäxai-sdkversiossa 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