Endpoint /v1/images/edits: Úprava vašich obrázků
Na této stránce
Aktualizováno 2. listopadu 2026 — Imagine. Model
grok-imagine-image-qualitybyl 2. listopadu 2026 odstraněn (jeho požadavky jsou nyní obsluhovány modelem Imagine 2.0 v kvalitělow): příklady nyní využívajígrok-imagine-image(Imagine 1.0) agrok-imagine-image-2.0(Imagine 2.0, kvalitalow,mediumneboauto). Při použití OpenAI SDK procházejí parametryaspect_ratio,resolutionaqualitypřesextra_body, zatímco úpravy vyžadují xAI SDK nebo přímý HTTP požadavek.
Úprava obrázků pomocí Grok API
Kromě generování nabízí xAI API vyhrazený endpoint pro úpravu existujících obrázků: POST /v1/images/edits. Tento endpoint ti umožňuje měnit, transformovat nebo vylepšovat obrázky tím, že popíšeš požadované změny jednoduchým textovým promptem.
Struktura požadavku na úpravu
Úprava funguje podobně jako generování, ale s jedním zásadním rozdílem, který mění způsob, jakým píšeš prompty: prompt popisuje modifikaci, nikoliv výsledný obrázek. Zatímco „Žena se slunečními brýlemi“ vygeneruje úplně nový obrázek, „Přidej sluneční brýle“ zachová původní fotografii a zasáhne pouze do daného místa. To je nejčastější zdroj zmatku při prvním pokusu a vysvětluje většinu neuspokojivých výsledků.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Přidej postavě červený klobouk",
"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"]
Proč použít requests místo OpenAI SDK?
Zde narazíš na technickou past této lekce, o které bys měl vědět dřív, než ztratíš hodinu času: kompatibilita s OpenAI SDK, která funguje perfektně pro generování, končí u úprav. Endpoint pro úpravy v xAI používá formát JSON, zatímco metoda images.edit() v SDK odesílá data jako multipart/form-data. Tato nekompatibilita typů obsahu znamená, že pro úpravy musíš použít REST API přímo prostřednictvím knihovny requests.
# NEFUNGUJE s xAI API
# client.images.edit(...) # Odesílá multipart, nikoliv JSON
# FUNGUJE: přímý volání REST
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Parametry endpointu pro úpravy
model(povinné):grok-imagine-image(Imagine 1.0) nebogrok-imagine-image-2.0(Imagine 2.0, který také přijímá parametrquality)prompt(povinné): popis modifikace, kterou chceš provéstimage: objekt obsahující URL jednoho zdrojového obrázkuimages: pole objektů pro více zdrojových obrázků (vzájemně se vylučuje simage)mask: objekt obsahující URL masky oblasti k úpravěn: počet variant k vygenerování (1 až 10)response_format:urlnebob64_json
Typy možných úprav
Následujících pět kategorií nemá stejnou míru úspěšnosti a je dobré to vědět, než slíbíš konkrétní výsledek. Přidávání prvků a změna atmosféry fungují velmi dobře, protože vycházejí z existujícího obsahu. Odstraňování je složitější – model musí rekonstruovat to, co bylo za odstraněným prvkem – a právě zde se stává maska nezbytnou, protože přesně vymezuje oblast k přepočítání.
- Přidání prvků: „Přidej postavě sluneční brýle“
- Odstranění: „Odstraň pozadí a nahraď ho bílým pozadím“
- Transformace stylu: „Převeď tuto fotografii do akvarelové ilustrace“
- Změna atmosféry: „Změň scénu z dne na noc“
- Korekce: „Zlepši osvětlení a zvýš kontrast“
# Příklad: změna stylu obrázku
payload = {
"model": "grok-imagine-image",
"prompt": "Transformuj tuto fotografii do ilustrace ve stylu franko-belgického komiksu",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktické cvičení
Zkus upravit obrázek ve více krocích. Začni jednoduchou modifikací a poté ji upravuj:
# Krok 1: úprava pozadí
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Nahraď pozadí západem slunce nad oceánem",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Klíčové poznatky
- Endpoint pro úpravy je
POST /v1/images/edits - V Pythonu používej
requests, nikoliv OpenAI SDK (nekompatibilita formátu) - Na jeden požadavek můžeš poskytnout až 5 zdrojových obrázků
- Prompt popisuje požadovanou modifikaci přirozeným jazykem
- Pro úpravy jsou dostupné oba modely (Imagine 1.0 i Imagine 2.0); metoda
images.edit()z OpenAI SDK není v xAI podporována: použij xAI SDK nebo HTTP požadavek