Endpoint /v1/images/edits: Szerkeszd a képeidet
Ezen az oldalon
Frissítve: 2026. november 2. — Imagine. A
grok-imagine-image-qualitymodellt 2026. november 2-án megszüntették (a kéréseit az Imagine 2.0 szolgálja kilowminőségben): a példák most agrok-imagine-image(Imagine 1.0) és agrok-imagine-image-2.0(Imagine 2.0,low,mediumvagyautominőség) modelleket használják. Az OpenAI SDK-val azaspect_ratio,resolutionésqualityparamétereket azextra_bodyobjektumon keresztül kell megadni, míg a szerkesztéshez az xAI SDK-t vagy egy közvetlen HTTP-kérést kell használnod.
Képszerkesztés a Grok API-val
A képgenerálás mellett az xAI API egy dedikált endpointot kínál meglévő képek szerkesztésére: POST /v1/images/edits. Ezzel az endpointtal módosíthatsz, átalakíthatsz vagy javíthatsz képeket úgy, hogy egy egyszerű szöveges promptban írod le a kívánt változtatásokat.
A szerkesztési kérés felépítése
A szerkesztés működése hasonló a generáláshoz, de van egy különbség, ami mindent megváltoztat a promptok megírásában: a prompt a módosítást írja le, nem a végső képet. A „Napszemüveges nő“ prompt egy teljes képet generál újra; az „Adj napszemüveget“ prompt megtartja a fotót, és csak ezen a ponton avatkozik be. Ez a leggyakoribb hiba az első próbálkozásoknál, és ez magyarázza a legtöbb csalódást okozó eredményt.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Adj egy piros kalapot a karakterhez",
"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"]
Miért használd a requests könyvtárat az OpenAI SDK helyett?
Itt jön a lecke technikai buktatója, és érdemes ezt tudnod, mielőtt egy órát pazarolnál rá: az OpenAI SDK-val való kompatibilitás, amely tökéletesen működik a generálásnál, a szerkesztésnél véget ér. Az xAI szerkesztő endpointja JSON formátumot használ, míg az SDK images.edit() metódusa multipart/form-data adatot küld. Ez a tartalomtípus-összeférhetetlenség azt jelenti, hogy a szerkesztésekhez közvetlenül a REST API-t kell használnod a requests könyvtárral.
# NEM MŰKÖDIK az xAI API-val
# client.images.edit(...) # Multipart adatot küld, nem JSON-t
# MŰKÖDIK: közvetlen REST hívás
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
A szerkesztési endpoint paraméterei
model(kötelező):grok-imagine-image(Imagine 1.0) vagygrok-imagine-image-2.0(Imagine 2.0, amely elfogadja aqualityparamétert is)prompt(kötelező): az alkalmazandó módosítás leírásaimage: objektum, amely egyetlen forráskép URL-jét tartalmazzaimages: objektumok tömbje több forráskép esetén (kölcsönösen kizárja azimageparamétert)mask: objektum, amely a szerkesztendő terület maszkjának URL-jét tartalmazzan: a generálandó variánsok száma (1 és 10 között)response_format:urlvagyb64_json
Lehetséges szerkesztési típusok
Az alábbi öt kategória nem rendelkezik azonos sikeraránnyal, és segít, ha ezt tudod, mielőtt eredményt ígérsz. Az elemek hozzáadása és a hangulat megváltoztatása nagyon jól működik, mivel ezek a meglévő tartalomra építenek. Az eltávolítás trükkösebb – a modellnek rekonstruálnia kell, mi volt az eltávolított elem mögött –, és itt válik elengedhetetlenné a maszk használata, mivel ez határolja be pontosan az újraszámolandó területet.
- Elemek hozzáadása: „Adj napszemüveget a karakterhez“
- Eltávolítás: „Távolítsd el a hátteret, és cseréld le fehér háttérre“
- Stílustranszformáció: „Alakítsd át ezt a fotót vízfesték illusztrációvá“
- Hangulatmódosítás: „Változtasd meg a jelenetet nappaliból éjszakaiba“
- Korrektúra: „Javítsd a világítást és növeld a kontrasztot“
# Példa: kép stílusának megváltoztatása
payload = {
"model": "grok-imagine-image",
"prompt": "Alakítsd át ezt a fotót franko-belga képregény stílusú illusztrációvá",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Gyakorlati feladat
Próbáld meg egy kép szerkesztését több lépésben. Kezdj egy egyszerű módosítással, majd finomítsd azt:
# 1. lépés: a háttér módosítása
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Cseréld le a hátteret egy naplementés óceáni tájra",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Főbb megállapítások
- A szerkesztési endpoint:
POST /v1/images/edits - Pythonban használd a
requestskönyvtárat, ne az OpenAI SDK-t (formátum-összeférhetetlenség miatt) - Kérésenként legfeljebb 5 forrásképet adhatsz meg
- A prompt természetes nyelven írja le a kívánt módosítást
- Mindkét modell (Imagine 1.0 és Imagine 2.0) elérhető szerkesztéshez; az OpenAI SDK
images.edit()metódusát az xAI nem támogatja: használd az xAI SDK-t vagy egy HTTP-kérést