Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Krajnja točka /v1/images/edits: Uređivanje slika

Lekcija 5 od 14 Ažurirano 2. studenoga 2026. Početnik
Na ovoj stranici
  1. Uređivanje slika putem Grok API-ja
  2. Struktura zahtjeva za uređivanje
  3. Zašto koristiti requests umjesto OpenAI SDK-a?
  4. Parametri krajnje točke za uređivanje
  5. Vrste mogućih uređivanja
  6. Praktična vježba
  7. Ključne točke

Ažurirano 2. studenoga 2026. — Imagine. grok-imagine-image-quality uklonjen je 2. studenoga 2026. (njegovi se zahtjevi obrađuju putem Imagine 2.0 u low kvaliteti): primjeri sada koriste grok-imagine-image (Imagine 1.0) i grok-imagine-image-2.0 (Imagine 2.0, low, medium ili auto kvaliteta). Uz OpenAI SDK, parametri aspect_ratio, resolution i quality prosljeđuju se kroz extra_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.

5
Maksimalan broj izvornih slika
2
Ulazni formati
JSON
Obavezan Content-Type
∞
Krugova uređivanja

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) ili grok-imagine-image-2.0 (Imagine 2.0, koji također prihvaća quality)
  • prompt (obavezno): opis modifikacije koju treba primijeniti
  • image: objekt koji sadrži URL jedne izvorne slike
  • images: niz objekata za više izvornih slika (međusobno isključivo s image)
  • mask: objekt koji sadrži URL maske područja koje treba urediti
  • n: broj varijanti za generiranje (1 do 10)
  • response_format: url ili b64_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