Giniúint bhaisce agus an paraiméadar n
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026 — Imagine. Baineadh
grok-imagine-image-qualityan 2 Samhain, 2026 (freagraítear a chuid iarratas anois le Imagine 2.0 i gcáilíochtlow): úsáideann na samplaí anoisgrok-imagine-image(Imagine 1.0) agusgrok-imagine-image-2.0(Imagine 2.0, cáilíochtlow,medium, nóauto). Leis an OpenAI SDK, seoltaraspect_ratio,resolution, agusqualitytríextra_body, agus déileáiltear le heagarthóireacht trí xAI SDK nó trí iarratas HTTP.
Ilíomhánna a ghiniúint in aon iarratas amháin
Ligeann an paraiméadar n san API giniúna duit suas le 10 íomhá a tháirgeadh ó leid amháin. Is éagsúlacht uathúil gach íomhá, rud a thugann raon roghanna duit chun an toradh is fearr a roghnú nó gailearaí amhairc a thógáil.
An paraiméadar n go mion
Glacann an paraiméadar n le slánuimhir idir 1 agus 10, agus is é 1 an luach réamhshocraithe. Luíonn a fhíorluach i airí de ghiniúint íomhánna atá furasta a dhéanamh dearmad de: tá an toradh neamhchinntitheach. Cruthaíonn an leid céanna íomhánna difriúla gach uair a ghlaonn tú air, agus níl aon cheann níos “cearta” ná a chéile. Ní dramhaíl é ceithre éagsúlacht a ghiniúint ag an am céanna; is admháil é nach bhfuil a fhios agat roimh ré cé acu ceann a oibreoidh.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
# 5 éagsúlacht a ghiniúint
response = client.images.generate(
model="grok-imagine-image",
prompt="A zen Japanese garden with a red bridge, ukiyo-e style",
n=5,
extra_body={"aspect_ratio": "16:9", "resolution": "1k"},
)
for i, image in enumerate(response.data):
print(f"Variation {i + 1}: {image.url}")
Tionchar ar chostais agus ar theorainneacha ráta
Is é an pointe tábhachtach le tuiscint sula dtógann tú píblíne air seo: ní lascaine é n=10. Íocann tú as deich n-íomhá agus caitear deich n-aonad de do theorainn ráta, díreach mar a dhéanfá le deich nglaoch ar leith. Is é an t-aon bhuntáiste ná an líonra — turas amháin in ionad deich — rud a chabhraíonn le moill, ach ní athraíonn sé an buiséad.
| Paraiméadar | n=1 | n=5 | n=10 |
|---|---|---|---|
| Costas (Imagine 1.0) | $0.02 | $0.10 | $0.20 |
| Costas (Imagine 2.0, low) | $0.04 | $0.20 | $0.40 |
| Íomhánna ginte | 1 | 5 | 10 |
Caitear an buiséad céanna le hiarratas ina bhfuil n=10 agus le 10 n-iarratas ar leith ina bhfuil n=1, ach tá sé níos tapúla toisc nach dteastaíonn ach glaoch líonra amháin.
Straitéisí roghnúcháin
Má ghineann tú deich n-éagsúlacht gan modh sórtála, ní dhéanann tú ach an fhadhb a aistriú: bhí íomhá amháin neamhchinnte agat, agus anois tá deich n-íomhá le breithiúnas a dhéanamh orthu. Is é an cheist le réiteach ar dtús ná an critéar — aeistéitiúil, áit a bhfuil an tsúil dhaonna dosháraithe fós; nó incháilaithe (an bhfuil an táirge le feiceáil, an bhfuil an téacs inléite, an bhfuil an formáid urramaithe), áit a bhféadfar uathoibriú a dhéanamh.
Roghnú láimhe
I gcásanna criticiúla (fógraíocht, clúdaigh leabhar), íoslódáil gach éagsúlacht agus déan comparáid amhairc orthu:
import urllib.request
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Science fiction book cover, organic spaceship",
n=8,
extra_body={"aspect_ratio": "3:4", "resolution": "2k"},
)
for i, image in enumerate(response.data):
urllib.request.urlretrieve(image.url, f"variation_{i + 1}.png")
print(f"Variation {i + 1} saved")
Roghnú uathoibrithe
Oibríonn sé má úsáideann tú samradh fise (vision model) chun breithiúnas a dhéanamh ar na híomhánna faoi choinníoll amháin: ní mór don chritéar a bheith fíorasach. Faigheann “An bhfuil táirge sa lár ar chúlra soladach san íomhá seo?” freagra iontaofa; faigheann “cé acu ceann is áille?” freagra treallach a chuirtear i láthair le muinín. Cuir critéir incháilite in iúl, agus coinnigh an breithiúnas aeistéitiúil duit féin.
def generate_and_select(prompt, n=5):
"""Gin n éagsúlacht agus fill gach URL."""
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=n
)
return [image.url for image in response.data]
Baisceáil il-leideanna
Chun íomhánna a ghiniúint ó leideanna éagsúla, comhcheangail na glaonna:
prompts = [
"Illustration of a Parisian café, impressionist style",
"Aerial view of terraced rice fields, photographic style",
"Interior of an old library, dim lighting"
]
all_results = {}
for prompt in prompts:
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=3
)
all_results[prompt] = [img.url for img in response.data]
# 3 leid x 3 éagsúlacht = 9 íomhá, costas iomlán: $0.18
Íoslódáil bhaisce
Seo an nós le forbairt ón gcéad líne cóid, ní nuair a imrítear é ar tháirgeadh: téann URLanna in éag. Is baisce caillte é baisce deich n-íomhá a ghintear ar maidin agus a íoslódáiltear tráthnóna — agus caithfidh tú íoc as arís.
import urllib.request
import os
def download_batch(response, output_dir="generated"):
"""Íoslódáil gach íomhá ó fhreagra."""
os.makedirs(output_dir, exist_ok=True)
for i, image in enumerate(response.data):
filepath = os.path.join(output_dir, f"image_{i + 1}.png")
urllib.request.urlretrieve(image.url, filepath)
print(f"{len(response.data)} images saved in {output_dir}/")
Praghsáil ón 5 Lúnasa, 2026 — athraíonn praghsanna go rialta: sula ndéanann tú aon ríomh buiséid, seiceáil an cárta rátaí reatha ar leathanach oifigiúil samhlacha agus praghsanna xAI.
Príomhphointí
- Ligeann an paraiméadar
nduit 1 go 10 n-éagsúlacht a ghiniúint in aghaidh an iarratais - Comhaireamhtar gach íomhá go haonair chun críocha billeála
- Tá giniúint i mbaisce (iarratas amháin le n>1) níos tapúla ná n iarratas ar leith
- Íoslódáil na torthaí láithreach toisc go bhfuil na URLanna sealadach
- Úsáid n=3 go 5 chun iniúchadh a dhéanamh, agus n=1 le haghaidh táirgeadh spriocdhírithe