Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Končna točka /v1/images/edits: Urejanje slik

Lekcija 5 od 14 Posodobljeno 2. november 2026 Začetnik
Na tej strani
  1. Urejanje slik z API-jem Grok
  2. Struktura zahteve za urejanje
  3. Zakaj uporabiti requests namesto OpenAI SDK?
  4. Parametri končne točke za urejanje
  5. Vrste možnih urejanj
  6. Praktična vaja
  7. Ključne ugotovitve

Posodobljeno 2. novembra 2026 — Imagine. Model grok-imagine-image-quality so 2. novembra 2026 umaknili (njegove zahteve zdaj obdeluje Imagine 2.0 v kakovosti low): primeri zdaj uporabljajo grok-imagine-image (Imagine 1.0) in grok-imagine-image-2.0 (Imagine 2.0, kakovost low, medium ali auto). Pri uporabi OpenAI SDK parametre aspect_ratio, resolution in quality posreduješ prek extra_body, urejanje pa zahteva xAI SDK ali neposreden HTTP klic.

Urejanje slik z API-jem Grok

Poleg generiranja API xAI ponuja namensko končno točko za urejanje obstoječih slik: POST /v1/images/edits. Ta končna točka ti omogoča spreminjanje, preoblikovanje ali izboljšavo slik tako, da želeno spremembo opišeš v preprostem besedilnem pozivu.

5
Največje število izvornih slik
2
Vhodni formati
JSON
Zahtevan Content-Type
∞
Krogi urejanja

Struktura zahteve za urejanje

Urejanje deluje podobno kot generiranje, z eno ključno razliko, ki popolnoma spremeni način pisanja pozivov: poziv opisuje spremembo, ne končne slike. „Ženska s sončnimi očali” ponovno ustvari celotno sliko; „dodaj sončna očala” ohrani fotografijo in poseže le na tistem delu. To je najpogostejša napaka pri prvem poskusu in razlaga večino razočarajočih rezultatov.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
    "Content-Type": "application/json"
}

payload = {
    "model": "grok-imagine-image",
    "prompt": "Dodaj rdeč klobuk liku",
    "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"]

Zakaj uporabiti requests namesto OpenAI SDK?

Tu je tehnična past te lekcije, ki jo moraš poznati, preden zapraviš uro časa: združljivost z OpenAI SDK, ki odlično deluje za generiranje, se pri urejanju konča. Končna točka za urejanje xAI uporablja format JSON, medtem ko metoda images.edit() v SDK pošilja multipart/form-data. Zaradi te nezdružljivosti vsebinske vrste moraš za urejanje neposredno uporabiti REST API s knjižnico requests.

# NE DELUJE z API-jem xAI
# client.images.edit(...)  # Pošlje multipart, ne JSON

# DELUJE: neposreden klic REST
requests.post(
    "https://api.x.ai/v1/images/edits",
    headers=headers,
    json=payload
)

Parametri končne točke za urejanje

  • model (obvezno): grok-imagine-image (Imagine 1.0) ali grok-imagine-image-2.0 (Imagine 2.0, ki sprejema tudi quality)
  • prompt (obvezno): opis spremembe, ki jo želiš uporabiti
  • image: objekt, ki vsebuje URL ene izvorne slike
  • images: polje objektov za več izvornih slik (medsebojno izključujoče z image)
  • mask: objekt, ki vsebuje URL maske območja za urejanje
  • n: število variant za generiranje (od 1 do 10)
  • response_format: url ali b64_json

Vrste možnih urejanj

Spodnjih pet družin nima enake stopnje uspešnosti in to je dobro vedeti, preden obljubiš določen rezultat. Dodajanje elementov in spreminjanje vzdušja delujeta zelo dobro, saj temeljita na obstoječi vsebini. Odstranjevanje je zahtevnejše – model mora rekonstruirati tisto, kar je bilo za odstranjenim elementom – in prav tu postane maska nujna, saj natančno določi območje za ponovni izračun.

  • Dodajanje elementov: „Dodaj sončna očala liku”
  • Odstranjevanje: „Odstrani ozadje in ga nadomesti z belim ozadjem”
  • Preoblikovanje sloga: „Pretvori to fotografijo v akvarelno ilustracijo”
  • Sprememba vzdušja: „Spremeni prizor iz dneva v noč”
  • Popravek: „Izboljšaj osvetlitev in povečaj kontrast”
# Primer: sprememba sloga slike
payload = {
    "model": "grok-imagine-image",
    "prompt": "Pretvori to fotografijo v ilustracijo v slogu francosko-belgijskega stripa",
    "image": {
        "url": "https://exemple.com/photo-ville.jpg"
    }
}

Praktična vaja

Poskusi urediti sliko v več korakih. Začni s preprosto spremembo, nato jo izpopolni:

# 1. korak: sprememba ozadja
payload_step1 = {
    "model": "grok-imagine-image",
    "prompt": "Zamenjaj ozadje z zahodom sonca nad oceanom",
    "image": {"url": "https://exemple.com/portrait.jpg"}
}

Ključne ugotovitve

  • Končna točka za urejanje je POST /v1/images/edits
  • V Pythonu uporabi requests, ne OpenAI SDK (nezdružljivost formatov)
  • Na zahtevo lahko priložiš do 5 izvornih slik
  • Poziv v naravnem jeziku opiše želeno spremembo
  • Za urejanje sta na voljo oba modela (Imagine 1.0 in Imagine 2.0); OpenAI SDK ne podpira images.edit() pri xAI: uporabi xAI SDK ali HTTP zahtevo