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

Početna točka s krajnjom točkom /v1/images/generations

Lekcija 1 od 14 Ažurirano 3. studenoga 2026. Početnik
Na ovoj stranici
  1. Generiraj svoju prvu sliku s Grok API-jem
  2. Struktura zahtjeva za generiranje
  3. Parametri zahtjeva
  4. Format odgovora
  5. Praktična vježba
  6. Ključne točke

Lekcija dovršena 3. studenoga 2026. na temelju stranice Image Generation i referencije xAI Images API-ja: zadane vrijednosti (aspect_ratio postavljen na auto, resolution na 1k), parametar quality za Imagine 2.0 i JPEG kao zadani format. Izvori: Image Generation · Images API.

Generiraj svoju prvu sliku s Grok API-jem

Slika generirana pomoću Groka xAI API nudi namjensku krajnju točku za generiranje slika: POST /v1/images/generations. Ova krajnja točka omogućuje ti stvaranje slika iz tekstualnog opisa koristeći Grok Imagine modele. Bilo da želiš proizvesti ilustracije, marketinške vizuale ili kreativne prototipove, sve počinje ovom krajnjom točkom.

U ovoj lekciji naučit ćeš kako strukturirati zahtjev za generiranje slike i razumjeti temeljne parametre.

1
Krajnja točka za generiranje
2
Dostupni modeli
10
Maksimalan broj slika po zahtjevu
2k
Maksimalna rezolucija

Struktura zahtjeva za generiranje

Dva parametra dovoljna su za generiranje slike: model i upit (prompt). Svi ostali imaju zadane vrijednosti, što ti omogućuje da dobiješ prvi rezultat u samo tri retka – i točno to trebaš učiniti prije čitanja ostatka, kako bi imao sliku pred sobom na koju ćeš povezivati svaki parametar.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.images.generate(
    model="grok-imagine-image",
    prompt="A Breton lighthouse under a starry sky, watercolor style"
)

image_url = response.data[0].url
print(image_url)

xAI API kompatibilan je s OpenAI SDK-jem za generiranje slika: usmjeriš base_url na https://api.x.ai/v1, uneseš svoj xAI ključ, a ostatak tvog koda ostaje nepromijenjen. Imaj na umu opseg ove kompatibilnosti – vrijedi za generiranje, ali ne i za uređivanje, koje očekuje drugačiji format. Lekcija 5 obrađuje tu temu.

Parametri zahtjeva

Evo parametara koje možeš uključiti u svoj zahtjev:

  • model: model za generiranje koji ćeš koristiti (grok-imagine-image ili grok-imagine-image-2.0, vidi lekciju 2)
  • prompt: tekstualni opis željene slike
  • n: broj slika za generiranje (1 do 10, zadano: 1)
  • aspect_ratio: omjer stranica slike (auto po defaultu: model bira na temelju upita)
  • resolution: rezolucija (1k po defaultu ili 2k)
  • quality: low, medium ili auto (zadano) na Imagine 2.0, vidi lekciju 12
  • response_format: url (zadano) ili b64_json za primanje slike u Base64 formatu

Primjer sa svim parametrima

response = client.images.generate(
    model="grok-imagine-image",
    prompt="An enchanted forest with fireflies, digital art style",
    n=2,
    response_format="url",
    extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)

for image in response.data:
    print(image.url)

Format odgovora

Odgovor je uvijek polje (array), čak i za jednu sliku – iteriraj kroz njega umjesto da čitaš samo data[0], inače će ti se kod srušiti onog dana kada postaviš n=4. Svaki objekt sadrži:

  • url: privremeni URL slike (ako je response_format postavljen na url)
  • b64_json: Base64 podaci slike (ako je response_format postavljen na b64_json)

Vraćeni MIME tip može biti image/png, image/jpeg ili image/webp; zadani je image/jpeg, osim ako postavka kvalitete ne proizvede PNG.

Praktična vježba

Pokušaj generirati svoju prvu sliku prilagodbom upita svom profesionalnom kontekstu. Na primjer, za vizual u prezentaciji:

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Minimalist chart showing startup growth, "
           "blue and white colors, dark background, flat design style",
    extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)

Ključne točke

  • Krajnja točka za generiranje je POST /v1/images/generations
  • Dva parametra dovoljna su za početak: model i prompt
  • API je kompatibilan s OpenAI Python SDK-jem promjenom base_url
  • Možeš generirati do 10 slika po zahtjevu
  • Dostupne rezolucije su 1k (zadano) i 2k