Končna točka /v1/images/edits: Urejanje slik
Na tej strani
Posodobljeno 2. novembra 2026 — Imagine. Model
grok-imagine-image-qualityso 2. novembra 2026 umaknili (njegove zahteve zdaj obdeluje Imagine 2.0 v kakovostilow): primeri zdaj uporabljajogrok-imagine-image(Imagine 1.0) ingrok-imagine-image-2.0(Imagine 2.0, kakovostlow,mediumaliauto). Pri uporabi OpenAI SDK parametreaspect_ratio,resolutioninqualityposreduješ prekextra_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.
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) aligrok-imagine-image-2.0(Imagine 2.0, ki sprejema tudiquality)prompt(obvezno): opis spremembe, ki jo želiš uporabitiimage: objekt, ki vsebuje URL ene izvorne slikeimages: polje objektov za več izvornih slik (medsebojno izključujoče zimage)mask: objekt, ki vsebuje URL maske območja za urejanjen: število variant za generiranje (od 1 do 10)response_format:urlalib64_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