Point deiridh /v1/images/generations: Tús maith
Ar an leathanach seo
Cúrsa críochnaithe ar an 3 Samhain, 2026 bunaithe ar an leathanach Giniúint Íomhánna agus ar thagairt API Íomhánna xAI: luachanna réamhshocraithe (
aspect_ratiosocraithe goauto,resolutiongo1k), paraiméadarqualitydo Imagine 2.0, agus JPEG mar fhormáid réamhshocraithe. Foinse: Giniúint Íomhánna · API Íomhánna.
Do chéad íomhá a ghiniúint leis an API Grok
Tairgeann API xAI point deiridh tiomnaithe do ghiniúint íomhánna: POST /v1/images/generations. Ligeann an pointe deiridh seo duit íomhánna a chruthú ó chur síos téacsúil ag baint úsáide as samhlacha Grok Imagine. Cibé an bhfuil tú ag iarraidh léaráidí, ábhar margaíochta, nó fréamhshamhlacha cruthaitheacha a tháirgeadh, tosaíonn sé go léir leis an bpointe deiridh seo.
Sa cheacht seo, foghlaimeoidh tú conas iarratas giniúna íomhá a struchtúrú agus na paraiméadair bhunúsacha a thuiscint.
Struchtúr Iarratais Giniúna
Tá dhá pharaiméadar leordhóthanach chun íomhá a ghiniúint: an tsamhail agus an leid (prompt). Tá luachanna réamhshocraithe ag gach paraiméadar eile, rud a ligeann duit an chéad toradh a fháil i dtrí líne—agus sin díreach ba chóir duit a dhéanamh sula léann tú an chuid eile, ionas go mbeidh íomhá os do chomhair chun gach paraiméadar a nascadh léi.
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="Teach solais Breataineach faoi spéir réaltaí, stíl uisce-datha"
)
image_url = response.data[0].url
print(image_url)
Tá API xAI comhoiriúnach le SDK OpenAI do ghiniúint íomhánna: díreoidh tú an base_url ar https://api.x.ai/v1, soláthróidh tú do eochair xAI, agus fanfaidh an chuid eile de do chód gan athrú. Coinnigh i gcuimhne raon feidhme na comhoiriúnachta seo—baineann sé le giniúint, ach ní le heagarthóireacht, a bhfuil formáid difriúil ag teastáil uirthi. Pléann Ceacht 5 é seo.
Paraiméadair an Iarratais
Seo iad na paraiméadair is féidir leat a chur san áireamh in d’iarratas:
model: an tsamhail ghiniúna le húsáid (grok-imagine-imagenógrok-imagine-image-2.0, féach ceacht 2)prompt: an cur síos téacsúil ar an íomhá atá uaitn: líon na n-íomhánna le giniúint (1 go 10, réamhshocrú: 1)aspect_ratio: cóimheas gnéithe na híomhá (autode réir réamhshocraithe: roghnaíonn an tsamhail bunaithe ar an leid)resolution: an taifeach (1kde réir réamhshocraithe, nó2k)quality:low,medium, nóauto(réamhshocrú) ar Imagine 2.0, féach ceacht 12response_format:url(réamhshocrú) nób64_jsonchun an íomhá a fháil i mBase64
Sampla le Gach Paraiméadar
response = client.images.generate(
model="grok-imagine-image",
prompt="Coill draíochta le cuileoga tine, stíl ealaíne digiteach",
n=2,
response_format="url",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
for image in response.data:
print(image.url)
Formáid na Freagartha
Is eagar í an fhreagra i gcónaí, fiú d’íomhá amháin—déan iteráil air seachas data[0] a léamh, nó brisfidh do chód an lá a shocraíonn tú n=4. Tá na rudaí seo a leanas i ngach oibiacht:
url: an URL sealadach don íomhá (má táresponse_formatsocraithe arurl)b64_json: na sonraí Base64 den íomhá (má táresponse_formatsocraithe arb64_json)
Is féidir leis an gcineál MIME a thugtar ar ais a bheith image/png, image/jpeg, nó image/webp; is é image/jpeg an réamhshocrú, mura dtáirgeann socruithe cáilíochta PNG.
Cleachtas Praicticiúil
Bain triail as do chéad íomhá a ghiniúint tríd an leid a oiriúnú do do chomhthéacs gairmiúil. Mar shampla, d’fhísualú láithreáin:
response = client.images.generate(
model="grok-imagine-image",
prompt="Cairt íostach ag taispeáint fáis tosaitheora, "
"dathanna gorma agus bána, cúlra dorcha, stíl dearaidh cothrom",
extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)
Príomhphointí
- Is é an pointe deiridh giniúna ná
POST /v1/images/generations - Níl ach dhá pharaiméadar ag teastáil chun tosú:
modelagusprompt - Tá an API comhoiriúnach le SDK Python OpenAI trí athrú a dhéanamh ar an
base_url - Is féidir leat suas le 10 n-íomhá a ghiniúint in aghaidh an iarratais
- Is iad
1k(réamhshocrú) agus2kna taifigh atá ar fáil