Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Koncový bod /v1/images/edits: Úprava vašich obrázkov

Lekcia 5 z 14 Aktualizované 2. novembra 2026 Začiatočník
Na tejto strane
  1. Úprava obrázkov pomocou Grok API
  2. Štruktúra požiadavky na úpravu
  3. Prečo použiť knižnicu requests namiesto OpenAI SDK?
  4. Parametre koncového bodu pre úpravy
  5. Typy možných úprav
  6. Praktické cvičenie
  7. Kľúčové poznatky

Aktualizované 2. novembra 2026 — Imagine. Model grok-imagine-image-quality bol 2. novembra 2026 odstránený (jeho požiadavky sú teraz obsluhované modelom Imagine 2.0 v kvalite low): príklady teraz využívajú grok-imagine-image (Imagine 1.0) a grok-imagine-image-2.0 (Imagine 2.0 s kvalitou low, medium alebo auto). Pri používaní OpenAI SDK prechádzajú parametre aspect_ratio, resolution a quality cez extra_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).

5
Maximálny počet zdrojových obrázkov
2
Vstupné formáty
JSON
Povinný Content-Type
∞
Kolá úprav

Š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) alebo grok-imagine-image-2.0 (Imagine 2.0, ktorý tiež akceptuje parameter quality)
  • prompt (povinné): opis úpravy, ktorá sa má vykonať
  • image: objekt obsahujúci URL adresu jedného zdrojového obrázka
  • images: pole objektov pre viacero zdrojových obrázkov (vzájomne sa vylučuje s parametrom image)
  • mask: objekt obsahujúci URL adresu masky oblasti, ktorá sa má upraviť
  • n: počet variantov na vygenerovanie (1 až 10)
  • response_format: url alebo b64_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