Končna točka /v1/images/generations: Začetek
Na tej strani
Lekcija zaključena 3. novembra 2026 na podlagi strani Image Generation in referenčne dokumentacije xAI Images API: privzete vrednosti (
aspect_rationastavljen naauto,resolutionna1k), parameterqualityza Imagine 2.0 in JPEG kot privzeti format. Viri: Ustvarjanje slik · Images API.
Ustvari svojo prvo sliko z Grok API
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.
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-imagealigrok-imagine-image-2.0, glej 2. lekcijo)prompt: besedilni opis želene sliken: število slik za ustvarjanje (od 1 do 10, privzeto: 1)aspect_ratio: razmerje stranic slike (autopo privzetem: model izbere na podlagi poziva)resolution: ločljivost (1kpo privzetem ali2k)quality:low,mediumaliauto(privzeto) pri Imagine 2.0, glej 12. lekcijoresponse_format:url(privzeto) alib64_jsonza 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 jeresponse_formatnastavljen naurl)b64_json: podatki slike v formatu Base64 (če jeresponse_formatnastavljen nab64_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:
modelinprompt - 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) in2k