Pabaigos taškas /v1/images/edits: redaguokite savo paveikslėlius
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 2 d. – Imagine.
grok-imagine-image-qualitybuvo pašalintas 2026 m. lapkričio 2 d. (jo užklausas dabar apdoroja Imagine 2.0 sulowkokybe): pavyzdžiuose naudojamigrok-imagine-image(Imagine 1.0) irgrok-imagine-image-2.0(Imagine 2.0,low,mediumarbaautokokybės). Naudojant OpenAI SDK, parametraiaspect_ratio,resolutionirqualityperduodami perextra_body, o redagavimui reikia naudoti xAI SDK arba tiesioginį HTTP užklausą.
Paveikslėlių redagavimas naudojant Grok API
Be generavimo, xAI API siūlo specialų pabaigos tašką esamiems paveikslėliams redaguoti: POST /v1/images/edits. Šis pabaigos taškas leidžia modifikuoti, transformuoti arba pagerinti paveikslėlius, paprastu teksto raginimu (prompt) aprašant norimus pakeitimus.
Redagavimo užklausos struktūra
Redagavimas veikia panašiai kaip generavimas, tačiau yra vienas esminis skirtumas, keičiantis tai, kaip rašai raginimus: raginimas aprašo pakeitimą, o ne galutinį paveikslėlį. „Moteris su akiniais nuo saulės“ sugeneruos visą naują paveikslėlį iš naujo; „pridėk akinius nuo saulės“ paliks nuotrauką ir įsikiš tik į tą konkrečią vietą. Tai dažniausia klaida pirmojo bandymo metu, ji paaiškina daugelį nuviliantičių rezultatų.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Pridėk raudoną kepurę veikėjui",
"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"]
Kodėl naudoti requests vietoj OpenAI SDK?
Štai techninė šios pamokos spąstai, apie kuriuos norėsi žinoti prieš švaistant valandą laiko: suderinamumas su OpenAI SDK, kuris puikiai veikia generuojant, baigiasi ties redagavimu. xAI redagavimo pabaigos taškas naudoja JSON formatą, tuo tarpu SDK metodas images.edit() siunčia multipart/form-data. Dėl šio turinio tipo nesuderinamumo redagavimui privalai tiesiogiai naudoti REST API su requests biblioteka.
# NEVEIKIA su xAI API
# client.images.edit(...) # Siunčia multipart, o ne JSON
# VEIKIA: tiesioginis REST kvietimas
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Redagavimo pabaigos taško parametrai
model(privaloma):grok-imagine-image(Imagine 1.0) arbagrok-imagine-image-2.0(Imagine 2.0, kuris taip pat priimaquality)prompt(privaloma): taikytino pakeitimo aprašymasimage: objektas, kuriame yra vieno šaltinio paveikslėlio URLimages: objektų masyvas keliems šaltinio paveikslėliams (negali būti naudojama kartu suimage)mask: objektas, kuriame yra redaguojamos srities kaukės URLn: generuotinų variantų skaičius (nuo 1 iki 10)response_format:urlarbab64_json
Galimų redagavimo tipai
Toliau išvardytos penkios šeimos neturi vienodos sėkmės tikimybės, ir tai naudinga žinoti prieš žadant rezultatą. Elementų pridėjimas ir atmosferos keitimas veikia labai gerai, nes remiasi esamu turiniu. Šalinimas yra sudėtingesnis – modelis turi rekonstruoti tai, kas buvo po pašalintu elementu – ir būtent čia kaukė tampa būtina, tiksliai apibrėždama perskaičiuotiną sritį.
- Elementų pridėjimas: „Pridėk veikėjui akinius nuo saulės“
- Šalinimas: „Pašalink foną ir pakeisk jį baltu fonu“
- Stiliaus transformacija: „Paversk šią nuotrauką akvarelės iliustracija“
- Atmosferos modifikavimas: „Pakeisk sceną iš dienos į naktį“
- Korekcija: „Pagerink apšvietimą ir padidink kontrastą“
# Pavyzdys: pakeisti paveikslėlio stilių
payload = {
"model": "grok-imagine-image",
"prompt": "Transformuok šią nuotrauką į frankų-belgų komiksų stiliaus iliustraciją",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktinė užduotis
Pabandyk redaguoti paveikslėlį keliais etapais. Pradėk nuo paprasto pakeitimo, tada tobulink:
# 1 žingsnis: pakeisti foną
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Pakeisk foną į saulėlydį virš vandenyno",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Svarbiausi punktai
- Redagavimo pabaigos taškas yra
POST /v1/images/edits - Python kalboje naudok
requests, o ne OpenAI SDK (formato nesuderinamumas) - Vienoje užklausoje gali pateikti iki 5 šaltinio paveikslėlių
- Raginimas natūralia kalba aprašo norimą pakeitimą
- Redagavimui available abu modeliai (Imagine 1.0 ir Imagine 2.0); naudojant OpenAI SDK,
images.edit()xAI nepalaikomas: naudok xAI SDK arba HTTP užklausą