Koncový bod /v1/images/edits: Úprava vašich obrázkov
Na tejto strane
Aktualizované 2. novembra 2026 — Imagine. Model
grok-imagine-image-qualitybol 2. novembra 2026 odstránený (jeho požiadavky sú teraz obsluhované modelom Imagine 2.0 v kvalitelow): príklady teraz využívajúgrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0 s kvalitoulow,mediumaleboauto). Pri používaní OpenAI SDK prechádzajú parametreaspect_ratio,resolutionaqualitycezextra_body, zatiaľ čo úpravy vyžadujú xAI SDK alebo priamy HTTP požiadavok.
Úprava obrázkov pomocou Grok API
Okrem generovania ponúka xAI API vyhradený koncový bod na úpravu existujúcich obrázkov: POST /v1/images/edits. Tento endpoint ti umožňuje meniť, transformovať alebo vylepšovať obrázky tým, že požadované zmeny opíšeš v jednoduchom textovom príkaze (prompte).
Štruktúra požiadavky na úpravu
Úprava funguje podobne ako generovanie, až na jeden zásadný rozdiel, ktorý mení spôsob, akým píšeš prompty: prompt opisuje zmenu, nie finálny obrázok. Príkaz „Žena so slnečnými okuliarmi“ vygeneruje úplne nový obrázok, zatiaľ čo „Pridaj slnečné okuliare“ zachová pôvodnú fotografiu a zasiahne len do danej oblasti. Toto je najčastejšia chyba pri prvom pokuse a vysvetľuje väčšinu sklamaných výsledkov.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Pridaj postave červený klobúk",
"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"]
Prečo použiť knižnicu requests namiesto OpenAI SDK?
Tu narážaš na technickú úskalie tejto lekcie, o ktorej by si mal vedieť skôr, než stratíš hodinu času: kompatibilita s OpenAI SDK, ktorá perfektne funguje pri generovaní, pri úpravách končí. Koncový bod pre úpravy v xAI používa formát JSON, zatiaľ čo metóda images.edit() v SDK odosiela dáta ako multipart/form-data. Táto nekompatibilita typov obsahu znamená, že pri úpravách musíš priamo využiť REST API pomocou knižnice requests.
# NEFUNGUJE s xAI API
# client.images.edit(...) # Odosiela multipart, nie JSON
# FUNGUJE: priamy volanie REST API
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Parametre koncového bodu pre úpravy
model(povinné):grok-imagine-image(Imagine 1.0) alebogrok-imagine-image-2.0(Imagine 2.0, ktorý tiež akceptuje parameterquality)prompt(povinné): opis úpravy, ktorá sa má vykonaťimage: objekt obsahujúci URL adresu jedného zdrojového obrázkaimages: pole objektov pre viacero zdrojových obrázkov (vzájomne sa vylučuje s parametromimage)mask: objekt obsahujúci URL adresu masky oblasti, ktorá sa má upraviťn: počet variantov na vygenerovanie (1 až 10)response_format:urlalebob64_json
Typy možných úprav
Nižšie uvedených päť kategórií nemá rovnakú úspešnosť a je dobré to vedieť skôr, než sľúbiš konkrétny výsledok. Pridávanie prvkov a zmena atmosféry fungujú veľmi dobre, pretože vychádzajú z existujúceho obsahu. Odstraňovanie je zložitejšie – model musí rekonštruovať to, čo sa nachádzalo za odstráneným prvkom – a práve tu sa stáva maska nevyhnutnou, pretože presne vymedzuje oblasť, ktorú treba prepočítať.
- Pridávanie prvkov: „Pridaj postave slnečné okuliare“
- Odstraňovanie: „Odstráň pozadie a nahraď ho bielym pozadím“
- Transformácia štýlu: „Preveď túto fotografiu na ilustráciu vo forme akvarelu“
- Zmena atmosféry: „Zmeň scénu z dňa na noc“
- Korekcia: „Vylepši osvetlenie a zvýš kontrast“
# Príklad: zmena štýlu obrázka
payload = {
"model": "grok-imagine-image",
"prompt": "Transformuj túto fotografiu na ilustráciu v štýle frankobelgického komiksu",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktické cvičenie
Skús upraviť obrázok vo viacerých krokoch. Začni jednoduchou úpravou a následne ju spresňuj:
# Krok 1: úprava pozadia
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Nahraď pozadie západom slnka nad oceánom",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Kľúčové poznatky
- Koncový bod pre úpravy je
POST /v1/images/edits - V Pythone používaj knižnicu
requests, nie OpenAI SDK (nekompatibilita formátov) - Na jednu požiadavku môžeš poskytnúť až 5 zdrojových obrázkov
- Prompt opisuje požadovanú úpravu prirodzeným jazykom
- Oba modely (Imagine 1.0 aj Imagine 2.0) sú dostupné pre úpravy; pri používaní OpenAI SDK nie je metóda
images.edit()podporovaná xAI: použij xAI SDK alebo HTTP požiadavok