Punkts /v1/images/generations: sākums
Šajā lapā
Nodarbība pabeigta 2026. gada 3. novembrī, balstoties uz Image Generation lapu un xAI Images API atsauces dokumentāciju: noklusējuma vērtības (
aspect_ratioiestatīts uzauto,resolutionuz1k), parametrsqualitypriekš Imagine 2.0 un JPEG kā noklusējuma formāts. Avoti: Image Generation · Images API.
Ģenerē savu pirmo attēlu ar Grok API
xAI API piedāvā specializētu punktu attēlu ģenerēšanai: POST /v1/images/generations. Šis punkts ļauj tev radīt attēlus no teksta apraksta, izmantojot Grok Imagine modeļus. Neatkarīgi no tā, vai vēlies izveidot ilustrācijas, mārketinga vizuālos materiālus vai radošus prototipus, viss sākas ar šo punktu.
Šajā nodarbībā tu uzzināsi, kā strukturēt attēla ģenerēšanas pieprasījumu un saprast pamatparametrus.
Ģenerēšanas pieprasījuma struktūra
Lai ģenerētu attēlu, pietiek ar diviem parametriem: modeli un uzdevumu (prompt). Visiem pārējiem ir noklusējuma vērtības, kas ļauj iegūt pirmo rezultātu tikai trīs koda rindās – un tieši tas tev ir jādara pirms turpmākās lasīšanas, lai tev būtu attēls acu priekšā, ar kuru saistīt katru parametru.
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 ir saderīgs ar OpenAI SDK attēlu ģenerēšanai: tu norādi base_url uz https://api.x.ai/v1, norādi savu xAI atslēgu, un pārējais tava koda saturs paliek nemainīgs. Paturi prātā šīs saderības robežas – tā attiecas uz ģenerēšanu, bet ne uz rediģēšanu, kas sagaida citu formātu. To aplūkosim 5. nodarbībā.
Pieprasījuma parametri
Lūk, parametri, kurus vari iekļaut savā pieprasījumā:
model: ģenerēšanai izmantojamais modelis (grok-imagine-imagevaigrok-imagine-image-2.0, skat. 2. nodarbību)prompt: vēlamā attēla teksta aprakstsn: ģenerējamo attēlu skaits (no 1 līdz 10, noklusējums: 1)aspect_ratio: attēla malu attiecība (autopēc noklusējuma: modelis izvēlas, balstoties uz uzdevumu)resolution: izšķirtspēja (1kpēc noklusējuma vai2k)quality:low,mediumvaiauto(noklusējums) priekš Imagine 2.0, skat. 12. nodarbīburesponse_format:url(noklusējums) vaib64_json, lai saņemtu attēlu Base64 formātā
Piemērs ar visiem parametriem
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)
Atbildes formāts
Atbilde vienmēr ir masīvs, pat ja tiek ģenerēts tikai viens attēls – iterē caur to, nevis lasi tieši data[0], pretējā gadījumā tavs kods sabruks tajā dienā, kad iestatīsi n=4. Katrs objekts satur:
url: pagaidu URL attēlam (jaresponse_formatirurl)b64_json: attēla Base64 dati (jaresponse_formatirb64_json)
Atgrieztais MIME tips var būt image/png, image/jpeg vai image/webp; pēc noklusējuma tas ir image/jpeg, ja vien kvalitātes iestatījums neizraisa PNG ģenerēšanu.
Praktiskais uzdevums
Mēģini ģenerēt savu pirmo attēlu, pielāgojot uzdevumu savam profesionālajam kontekstam. Piemēram, prezentācijas vizualizācijai:
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"},
)
Galvenās atziņas
- Ģenerēšanas punkts ir
POST /v1/images/generations - Sākumam pietiek ar diviem parametriem:
modelunprompt - API ir saderīgs ar OpenAI Python SDK, mainot
base_url - Vienā pieprasījumā vari ģenerēt līdz 10 attēliem
- Pieejamās izšķirtspējas ir
1k(noklusējums) un2k