Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Pabaigos taškas /v1/images/generations: pradžia

Paskaita 1 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Pradedantisiems
Šiame puslapyje
  1. Sugeneruokite savo pirmąjį vaizdą naudodami Grok API
  2. Generavimo užklausos struktūra
  3. Užklausos parametrai
  4. Atsakymo formatas
  5. Praktinė užduotis
  6. Svarbiausi punktai

Pamoka baigta 2026 m. lapkričio 3 d. remiantis Vaizdų generavimo puslapiu ir xAI vaizdų API nuoroda: numatytosios reikšmės (aspect_ratio nustatytas į auto, resolution į 1k), quality parametras „Imagine 2.0“ modeliui ir JPEG kaip numatytasis formatas. Šaltiniai: Vaizdų generavimas · Vaizdų API.

Sugeneruokite savo pirmąjį vaizdą naudodami Grok API

Grok sugeneruotas vaizdas xAI API siūlo specialų pabaigos tašką vaizdų generavimui: POST /v1/images/generations. Šis pabaigos taškas leidžia kurti vaizdus iš tekstinio aprašymo naudojant Grok Imagine modelius. Nesvarbu, ar norite kurti iliustracijas, rinkodaros vizualus, ar kūrybinius prototipus – viskas prasideda nuo šio pabaigos taško.

Šioje pamokoje sužinosite, kaip sustruktūruoti vaizdo generavimo užklausą ir suprasti pagrindinius parametrus.

1
Generavimo pabaigos taškas
2
Prieinami modeliai
10
Maksimalus vaizdų skaičius užklausai
2k
Maksimali raiška

Generavimo užklausos struktūra

Vaizdui sugeneruoti pakanka dviejų parametrų: modelio ir užuominos (prompt). Visi kiti turi numatytąsias reikšmes, todėl pirmąjį rezultatą galite gauti trimis eilutėmis – tai ir turėtumėte padaryti prieš skaitydami toliau, kad turėtumėte vaizdą prieš akis, su kuriuo galėtumėte susieti kiekvieną parametrą.

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 yra suderinamas su OpenAI SDK vaizdų generavimui: nukreipiate base_url į https://api.x.ai/v1, pateikiate savo xAI raktą, o likusi kodo dalis lieka nepakitusi. Turėkite omenyje šio suderinamumo apimtį – ji taikoma generavimui, bet ne redagavimui, kuriam tikimasi kito formato. Tai aptarsime 5 pamokoje.

Užklausos parametrai

Štai parametrai, kuriuos galite įtraukti į savo užklausą:

  • model: naudojamas generavimo modelis (grok-imagine-image arba grok-imagine-image-2.0, žr. 2 pamoką)
  • prompt: tekstinis pageidaujamo vaizdo aprašymas
  • n: generuojamų vaizdų skaičius (nuo 1 iki 10, numatytoji reikšmė: 1)
  • aspect_ratio: vaizdo kraštinių santykis (numatytoji reikšmė auto: modelis pasirenka pagal užuominą)
  • resolution: raiška (numatytoji reikšmė 1k arba 2k)
  • quality: low, medium arba auto (numatytoji) „Imagine 2.0“ modeliui, žr. 12 pamoką
  • response_format: url (numatytoji) arba b64_json, norint gauti vaizdą Base64 formatu

Pavyzdys su visais parametrais

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)

Atsakymo formatas

Atsakymas visada yra masyvas, net ir esant vienam vaizdui – iteruokite per jį, o ne skaitykite tiesiogiai data[0], kitaip jūsų kodas sugrius tą dieną, kai nustatysite n=4. Kiekvienas objektas turi:

  • url: laikinąjį vaizdo URL (jei response_format yra url)
  • b64_json: vaizdo Base64 duomenis (jei response_format yra b64_json)

Grąžinamas MIME tipas gali būti image/png, image/jpeg arba image/webp; numatytasis yra image/jpeg, nebent kokybės nustatymas sukuria PNG.

Praktinė užduotis

Pabandykite sugeneruoti savo pirmąjį vaizdą pritaikydami užuominą savo profesiniam kontekstui. Pavyzdžiui, prezentacijos vizualui:

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"},
)

Svarbiausi punktai

  • Generavimo pabaigos taškas yra POST /v1/images/generations
  • Pradėti pakanka dviejų parametrų: model ir prompt
  • API yra suderinamas su OpenAI Python SDK pakeitus base_url
  • Vienos užklausos metu galite sugeneruoti iki 10 vaizdų
  • Galimos raiškos yra 1k (numatytoji) ir 2k