Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Endpoint /v1/images/edits: Úprava vašich obrázků

Lekce 5 z 14 Aktualizováno 2. listopadu 2026 Začátečník
Na této stránce
  1. Úprava obrázků pomocí Grok API
  2. Struktura požadavku na úpravu
  3. Proč použít requests místo OpenAI SDK?
  4. Parametry endpointu pro úpravy
  5. Typy možných úprav
  6. Praktické cvičení
  7. Klíčové poznatky

Aktualizováno 2. listopadu 2026 — Imagine. Model grok-imagine-image-quality byl 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) a grok-imagine-image-2.0 (Imagine 2.0, kvalita low, medium nebo auto). Při použití OpenAI SDK procházejí parametry aspect_ratio, resolution a quality přes extra_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.

5
Maximální počet zdrojových obrázků
2
Vstupní formáty
JSON
Požadovaný Content-Type
∞
Kol úprav

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) nebo grok-imagine-image-2.0 (Imagine 2.0, který také přijímá parametr quality)
  • prompt (povinné): popis modifikace, kterou chceš provést
  • image: objekt obsahující URL jednoho zdrojového obrázku
  • images: pole objektů pro více zdrojových obrázků (vzájemně se vylučuje s image)
  • mask: objekt obsahující URL masky oblasti k úpravě
  • n: počet variant k vygenerování (1 až 10)
  • response_format: url nebo b64_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