Pabaigos taškas /v1/images/generations: pradžia
Šiame puslapyje
Pamoka baigta 2026 m. lapkričio 3 d. remiantis Vaizdų generavimo puslapiu ir xAI vaizdų API nuoroda: numatytosios reikšmės (
aspect_rationustatytas įauto,resolutionį1k),qualityparametras „Imagine 2.0“ modeliui ir JPEG kaip numatytasis formatas. Šaltiniai: Vaizdų generavimas · Vaizdų API.
Sugeneruokite savo pirmąjį vaizdą naudodami Grok API
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.
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-imagearbagrok-imagine-image-2.0, žr. 2 pamoką)prompt: tekstinis pageidaujamo vaizdo aprašymasn: 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ė1karba2k)quality:low,mediumarbaauto(numatytoji) „Imagine 2.0“ modeliui, žr. 12 pamokąresponse_format:url(numatytoji) arbab64_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 (jeiresponse_formatyraurl)b64_json: vaizdo Base64 duomenis (jeiresponse_formatyrab64_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ų:
modelirprompt - 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) ir2k