Lõpp-punkt /v1/images/edits: piltide muutmine
Sellel lehel
Uuendatud 2. novembril 2026 – Imagine.
grok-imagine-image-qualityeemaldati 2. novembril 2026 (selle päringuid teenindab nüüd Imagine 2.0 kvaliteedigalow): näited kasutavad edaspidi mudeleidgrok-imagine-image(Imagine 1.0) jagrok-imagine-image-2.0(Imagine 2.0, kvaliteedigalow,mediumvõiauto). OpenAI SDK puhul edastatakse parameetridaspect_ratio,resolutionjaqualityväljasextra_body; piltide muutmine nõuab xAI SDK-d või otsest HTTP-päringut.
Piltide muutmine Grok API-ga
Lisaks piltide loomisele pakub xAI API spetsiaalset lõpp-punkti olemasolevate piltide muutmiseks: POST /v1/images/edits. See lõpp-punkt võimaldab sul pilte muuta, teisendada või täiustada, kirjeldades soovitud muudatusi lihtsas tekstisisendis (prompt).
Muutmispäringu struktuur
Muutmine sarnaneb loomisega, kuid on üks oluline erinevus, mis mõjutab fundamentaalselt seda, kuidas sa sisendeid kirjutad: sisend kirjeldab muudatust, mitte lõplikku pilti. „Naine päikeseprillidega“ genereerib kogu pildi uuesti; „lisa päikeseprillid“ säilitab foto ja sekkub ainult sellesse detaili. See on kõige levinum viga esimesel katsel ja see selgitab enamikku pettumust valmistavaid tulemusi.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Lisa tegelasele punane müts",
"image": {
"url": "https://exemple.com/photo-personnage.jpg"
}
}
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
result = response.json()
edited_url = result["data"][0]["url"]
Miks kasutada requests-i OpenAI SDK asemel?
Siin peitub selle õppetüki tehniline lõks, millest tasub teada enne, kui kulutad sellele tund aega: ühilduvus OpenAI SDK-ga, mis toimib laitmatult piltide loomisel, lõpeb muutmisega. xAI muutmise lõpp-punkt kasutab JSON-formaati, samas kui SDK meetod images.edit() saadab andmed kujul multipart/form-data. See sisutüübi kokkusobimatus tähendab, et muutmiste jaoks pead kasutama otsest REST API-t koos Pythoni teegiga requests.
# EI TOIMI xAI API-ga
# client.images.edit(...) # Saadab multipart, mitte JSON
# TOIMIB: otsene REST-i väljakutse
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Muutmise lõpp-punkti parameetrid
model(kohustuslik):grok-imagine-image(Imagine 1.0) võigrok-imagine-image-2.0(Imagine 2.0, mis aktsepteerib ka parameetritquality)prompt(kohustuslik): kirjeldus rakendatavast muudatusestimage: objekt, mis sisaldab ühe allikapildi URL-iimages: objektide massiiv mitme allikapildi jaoks (vastastikku välistav parameetrigaimage)mask: objekt, mis sisaldab muudetava ala maski URL-in: genereeritavate variantide arv (1 kuni 10)response_format:urlvõib64_json
Võimalike muudatuste tüübid
Allpool toodud viiel kategoorial ei ole sama edu määr ja seda tasub teada enne, kui lubad kindlat tulemust. Elementide lisamine ja meeleolu muutmine toimivad väga hästi, kuna need tuginevad olemasolevale sisule. Eemaldamine on keerulisem – mudel peab rekonstrueerima selle, mis oli eemaldatud elemendi taga – ja just siin muutub mask hädavajalikuks, määratledes täpselt ala, mida ümber arvutada.
- Elementide lisamine: „Lisa tegelasele päikeseprillid“
- Eemaldamine: „Eemalda taust ja asenda see valge taustaga“
- Stiili teisendamine: „Teisenda see foto akvarellillustratsiooniks“
- Meeleolu muutmine: „Muuda stseen päevast ööks“
- Korrigeerimine: „Paranda valgustust ja suurenda kontrasti“
# Näide: pildi stiili muutmine
payload = {
"model": "grok-imagine-image",
"prompt": "Teisenda see foto franko-belgia koomiksistiilis illustratsiooniks",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktiline harjutus
Proovi pilti muuta mitmes etapis. Alusta lihtsast muudatusest ja seejärel täpsusta:
# 1. samm: tausta muutmine
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Asenda taust päikeseloojanguga ookeani kohal",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Peamised punktid
- Muutmise lõpp-punkt on
POST /v1/images/edits - Kasuta Pythonis teeki
requests, mitte OpenAI SDK-d (formaadi kokkusobimatus) - Ühes päringus saab esitada kuni 5 allikapilti
- Sisend kirjeldab soovitud muudatust loomulikus keeles
- Mõlemad mudelid (Imagine 1.0 ja Imagine 2.0) on muutmiseks saadaval; OpenAI SDK puhul ei toeta xAI meetodit
images.edit(): kasuta xAI SDK-d või HTTP-päringut