Početna točka s krajnjom točkom /v1/images/generations
Na ovoj stranici
Lekcija dovršena 3. studenoga 2026. na temelju stranice Image Generation i referencije xAI Images API-ja: zadane vrijednosti (
aspect_ratiopostavljen naauto,resolutionna1k), parametarqualityza Imagine 2.0 i JPEG kao zadani format. Izvori: Image Generation · Images API.
Generiraj svoju prvu sliku s Grok API-jem
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.
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-imageiligrok-imagine-image-2.0, vidi lekciju 2)prompt: tekstualni opis željene sliken: broj slika za generiranje (1 do 10, zadano: 1)aspect_ratio: omjer stranica slike (autopo defaultu: model bira na temelju upita)resolution: rezolucija (1kpo defaultu ili2k)quality:low,mediumiliauto(zadano) na Imagine 2.0, vidi lekciju 12response_format:url(zadano) ilib64_jsonza 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 jeresponse_formatpostavljen naurl)b64_json: Base64 podaci slike (ako jeresponse_formatpostavljen nab64_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:
modeliprompt - API je kompatibilan s OpenAI Python SDK-jem promjenom
base_url - Možeš generirati do 10 slika po zahtjevu
- Dostupne rezolucije su
1k(zadano) i2k