Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Končna točka /v1/images/generations: Začetek

Lekcija 1 od 14 Posodobljeno 3. november 2026 Začetnik
Na tej strani
  1. Ustvari svojo prvo sliko z Grok API
  2. Struktura zahteve za ustvarjanje
  3. Parametri zahteve
  4. Format odgovora
  5. Praktična vaja
  6. Ključne ugotovitve

Lekcija zaključena 3. novembra 2026 na podlagi strani Image Generation in referenčne dokumentacije xAI Images API: privzete vrednosti (aspect_ratio nastavljen na auto, resolution na 1k), parameter quality za Imagine 2.0 in JPEG kot privzeti format. Viri: Ustvarjanje slik · Images API.

Ustvari svojo prvo sliko z Grok API

Slika, ki jo je ustvaril Grok API xAI ponuja namensko končno točko za ustvarjanje slik: POST /v1/images/generations. Ta končna točka ti omogoča ustvarjanje slik na podlagi besedilnega opisa z uporabo modelov Grok Imagine. Ne glede na to, ali želiš izdelati ilustracije, vizuale za trženje ali kreativne prototipe, vse se začne s to končno točko.

V tej lekciji se boš naučil, kako strukturirati zahtevo za ustvarjanje slike in razumeti osnovne parametre.

1
Končna točka za ustvarjanje
2
Razpoložljivi modeli
10
Največje število slik na zahtevo
2k
Najvišja ločljivost

Struktura zahteve za ustvarjanje

Za ustvarjanje slike zadostujeta dva parametra: model in poziv (prompt). Vsi ostali imajo privzete vrednosti, kar ti omogoča, da do prvega rezultata prideš v treh vrsticah – in točno to moraš storiti, preden prebereš preostanek, da boš imel pred seboj sliko, na katero boš lahko navezal vsak parameter.

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)

API xAI je združljiv z OpenAI SDK za ustvarjanje slik: base_url usmeriš na https://api.x.ai/v1, vneseš svoj ključ xAI in preostanek kode ostane nespremenjen. Imej v mislih obseg te združljivosti – velja za ustvarjanje, ne pa za urejanje, ki pričakuje drugačen format. To pokriva 5. lekcija.

Parametri zahteve

Tukaj so parametri, ki jih lahko vključiš v svojo zahtevo:

  • model: model za ustvarjanje, ki ga želiš uporabiti (grok-imagine-image ali grok-imagine-image-2.0, glej 2. lekcijo)
  • prompt: besedilni opis želene slike
  • n: število slik za ustvarjanje (od 1 do 10, privzeto: 1)
  • aspect_ratio: razmerje stranic slike (auto po privzetem: model izbere na podlagi poziva)
  • resolution: ločljivost (1k po privzetem ali 2k)
  • quality: low, medium ali auto (privzeto) pri Imagine 2.0, glej 12. lekcijo
  • response_format: url (privzeto) ali b64_json za prejemanje slike v formatu Base64

Primer z vsemi parametri

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 vedno polje, tudi za eno samo sliko – iteriraj skozenj, namesto da bi bral le data[0], sicer se ti bo koda sesula, ko boš nekega dne nastavil n=4. Vsak objekt vsebuje:

  • url: začasni URL slike (če je response_format nastavljen na url)
  • b64_json: podatki slike v formatu Base64 (če je response_format nastavljen na b64_json)

Vrnjeni tip MIME je lahko image/png, image/jpeg ali image/webp; privzeto je image/jpeg, razen če nastavitev kakovosti proizvede PNG.

Praktična vaja

Poskusi ustvariti svojo prvo sliko tako, da prilagodiš poziv svojemu profesionalnemu kontekstu. Na primer, za vizual v predstavitvi:

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 ugotovitve

  • Končna točka za ustvarjanje je POST /v1/images/generations
  • Za začetek zadostujeta dva parametra: model in prompt
  • API je združljiv s Python SDK za OpenAI s spremembo base_url
  • Na zahtevo lahko ustvariš do 10 slik
  • Razpoložljivi ločljivosti sta 1k (privzeto) in 2k