Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Lõpp-punkt /v1/images/generations: alustamine

Õppetund 1 / 14 Värskendatud 3. november 2026 Algajatele
Sellel lehel
  1. Loo oma esimene pilt Grok API-ga
  2. Genereerimispäringu struktuur
  3. Päringu parameetrid
  4. Vastuse vorming
  5. Praktiline harjutus
  6. Peamised punktid

Tund lõpetatud 3. novembril 2026, tuginedes Piltide genereerimise lehele ja xAI piltide API referentsile: vaikimisi väärtused (aspect_ratio väärtusega auto, resolution väärtusega 1k), quality parameeter Imagine 2.0 jaoks ja JPEG vaikimisi vorminguna. Allikad: Piltide genereerimine · Piltide API.

Loo oma esimene pilt Grok API-ga

Grok-i loodud pilt 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.

1
Genereerimise lõpp-punkt
2
Saadaval olevad mudelid
10
Pilte maksimaalselt ühes päringus
2k
Maksimaalne eraldusvõime

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-image või grok-imagine-image-2.0, vt 2. tund)
  • prompt: soovitud pildi tekstiline kirjeldus
  • n: genereeritavate piltide arv (1 kuni 10, vaikimisi: 1)
  • aspect_ratio: pildi kuvasuhe (auto vaikimisi: mudel valib selle juhendi põhjal)
  • resolution: eraldusvõime (1k vaikimisi või 2k)
  • quality: low, medium või auto (vaikimisi) Imagine 2.0 puhul, vt 12. tund
  • response_format: url (vaikimisi) või b64_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 (kui response_format on url)
  • b64_json: pildi Base64-andmed (kui response_format on b64_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: model ja prompt
  • 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) ja 2k