Krajnja točka /v1/images/edits: Uređivanje slika
Na ovoj stranici
Ažurirano 2. studenoga 2026. — Imagine.
grok-imagine-image-qualityuklonjen je 2. studenoga 2026. (njegovi se zahtjevi obrađuju putem Imagine 2.0 ulowkvaliteti): primjeri sada koristegrok-imagine-image(Imagine 1.0) igrok-imagine-image-2.0(Imagine 2.0,low,mediumiliautokvaliteta). Uz OpenAI SDK, parametriaspect_ratio,resolutioniqualityprosljeđuju se krozextra_body, dok se uređivanje izvodi pomoću xAI SDK-a ili izravnog HTTP zahtjeva.
Uređivanje slika putem Grok API-ja
Osim generiranja, xAI API nudi namjensku krajnju točku za uređivanje postojećih slika: POST /v1/images/edits. Ova krajnja točka omogućuje ti modificiranje, transformiranje ili poboljšanje slika opisivanjem željenih promjena jednostavnim tekstualnim upitom.
Struktura zahtjeva za uređivanje
Uređivanje funkcionira slično kao generiranje, s jednom ključnom razlikom koja mijenja način na koji pišeš upite: upit opisuje modifikaciju, a ne konačnu sliku. „Žena sa sunčanim naočalama“ regenerirat će cijelu sliku; „dodaj sunčane naočale“ zadržat će fotografiju i intervenirati samo na tom dijelu. To je najčešća zabuna pri prvom pokušaju i objašnjava većinu razočaravajućih rezultata.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Dodaj crveni šešir 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"]
Zašto koristiti requests umjesto OpenAI SDK-a?
Evo tehničke zamke ove lekcije koju moraš znati prije nego što potrošiš sat vremena na nju: kompatibilnost s OpenAI SDK-om, koja savršeno funkcionira za generiranje, prestaje kod uređivanja. xAI krajnja točka za uređivanje koristi JSON format, dok metoda images.edit() SDK-a šalje multipart/form-data. Ova nekompatibilnost vrste sadržaja znači da za uređivanje moraš izravno koristiti REST API s bibliotekom requests.
# NE RADI s xAI API-jem
# client.images.edit(...) # Šalje multipart, a ne JSON
# RADI: izravan REST poziv
requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
)
Parametri krajnje točke za uređivanje
model(obavezno):grok-imagine-image(Imagine 1.0) iligrok-imagine-image-2.0(Imagine 2.0, koji također prihvaćaquality)prompt(obavezno): opis modifikacije koju treba primijenitiimage: objekt koji sadrži URL jedne izvorne slikeimages: niz objekata za više izvornih slika (međusobno isključivo simage)mask: objekt koji sadrži URL maske područja koje treba ureditin: broj varijanti za generiranje (1 do 10)response_format:urlilib64_json
Vrste mogućih uređivanja
Pet donjih kategorija nemaju istu stopu uspješnosti, a korisno je to znati prije obećavanja rezultata. Dodavanje elemenata i promjena atmosfere vrlo dobro funkcioniraju jer se oslanjaju na postojeći sadržaj. Uklanjanje je složenije — model mora rekonstruirati ono što se nalazilo iza uklonjenog elementa — i tu maska postaje ključna jer precizno određuje područje koje treba ponovno izračunati.
- Dodavanje elemenata: „Dodaj sunčane naočale liku“
- Uklanjanje: „Ukloni pozadinu i zamijeni je bijelom pozadinom“
- Transformacija stila: „Pretvori ovu fotografiju u ilustraciju u stilu akvarela“
- Modifikacija atmosfere: „Promijeni scenu iz dana u noć“
- Korekcija: „Poboljšaj osvjetljenje i povećaj kontrast“
# Primjer: promjena stila slike
payload = {
"model": "grok-imagine-image",
"prompt": "Transformiraj ovu fotografiju u ilustraciju u stilu francusko-belgijskog stripa",
"image": {
"url": "https://exemple.com/photo-ville.jpg"
}
}
Praktična vježba
Isprobaj uređivanje slike u više koraka. Započni jednostavnom modifikacijom, a zatim usavrši rezultat:
# Korak 1: modificiranje pozadine
payload_step1 = {
"model": "grok-imagine-image",
"prompt": "Zamijeni pozadinu zalaskom sunca nad oceanom",
"image": {"url": "https://exemple.com/portrait.jpg"}
}
Ključne točke
- Krajnja točka za uređivanje je
POST /v1/images/edits - U Pythonu koristi
requests, a ne OpenAI SDK (nekompatibilnost formata) - Možeš dostaviti do 5 izvornih slika po zahtjevu
- Upit opisuje željenu modifikaciju prirodnim jezikom
- Obaju modela (Imagine 1.0 i Imagine 2.0) dostupna su za uređivanje; uz OpenAI SDK,
images.edit()nije podržan od strane xAI-ja: koristi xAI SDK ili HTTP zahtjev