Lõpp-punkt /v1/images/generations: alustamine
Sellel lehel
Tund lõpetatud 3. novembril 2026, tuginedes Piltide genereerimise lehele ja xAI piltide API referentsile: vaikimisi väärtused (
aspect_ratioväärtusegaauto,resolutionväärtusega1k),qualityparameeter Imagine 2.0 jaoks ja JPEG vaikimisi vorminguna. Allikad: Piltide genereerimine · Piltide API.
Loo oma esimene pilt Grok API-ga
xAI API pakub piltide genereerimiseks spetsiaalset lõpp-punkti: POST /v1/images/generations. See lõpp-punkt võimaldab luua pilte tekstikirjelduse põhjal, kasutades Grok Imagine mudeleid. Olgu sul vaja illustreerida artiklit, luua turundusmaterjale või teha loomingulisi prototüüpe – kõik algab just sellest lõpp-punktist.
Selles tunnis õpid, kuidas koostada pildi genereerimise päring ja mõista selle põhiparameetreid.
Genereerimispäringu struktuur
Pildi loomiseks piisab kahest parameetrist: mudelist ja juhendist (prompt). Kõigil teistel on vaikimisi väärtused, mis võimaldab sul esimese tulemuse kätte saada vaid kolme koodireaga. Tee just nii enne edasilugemist – siis on sul ees konkreetne pilt, millega seostada iga parameetri mõju.
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 on piltide genereerimisel ühilduv OpenAI SDK-ga: suuna base_url aadressile https://api.x.ai/v1, sisesta oma xAI võti ja ülejäänud kood jääb muutmata. Pea meeles selle ühilduvuse ulatust – see kehtib genereerimise kohta, kuid ei kehti redigeerimise puhul, mis eeldab teistsugust vormingut. Sellest räägime 5. tunnis.
Päringu parameetrid
Siin on parameetrid, mida saad oma päringus kasutada:
model: genereerimismudel (grok-imagine-imagevõigrok-imagine-image-2.0, vt 2. tund)prompt: soovitud pildi tekstiline kirjeldusn: genereeritavate piltide arv (1 kuni 10, vaikimisi: 1)aspect_ratio: pildi kuvasuhe (autovaikimisi: mudel valib selle juhendi põhjal)resolution: eraldusvõime (1kvaikimisi või2k)quality:low,mediumvõiauto(vaikimisi) Imagine 2.0 puhul, vt 12. tundresponse_format:url(vaikimisi) võib64_json, et saada pilt Base64-kodeeringus
Näide kõigi parameetritega
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)
Vastuse vorming
Vastus on alati massiiv, isegi kui genereeritakse ainult üks pilt – iterreeri selle üle, mitte ära loe otse data[0], vastasel juhul läheb su kood katki päeval, kui määrad n=4. Iga objekt sisaldab:
url: pildi ajutine URL (kuiresponse_formatonurl)b64_json: pildi Base64-andmed (kuiresponse_formatonb64_json)
Tagastatav MIME-tüüp võib olla image/png, image/jpeg või image/webp; vaikimisi on see image/jpeg, välja arvatud juhul, kui kvaliteedisäte toodab PNG-vormingu.
Praktiline harjutus
Proovi luua oma esimene pilt, kohandades juhendit oma professionaalse kontekstiga. Näiteks esitluse visuaali jaoks:
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"},
)
Peamised punktid
- Genereerimise lõpp-punkt on
POST /v1/images/generations - Alustamiseks piisab kahest parameetrist:
modeljaprompt - API on ühilduv OpenAI Python SDK-ga, muutes vaid
base_url - Ühes päringus saab genereerida kuni 10 pilti
- Saadaval olevad eraldusvõimed on
1k(vaikimisi) ja2k