Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Point deiridh /v1/images/generations: Tús maith

Ceacht 1 as 14 Nuashonraithe 3 Samhain 2026 Doicnéir
Ar an leathanach seo
  1. Do chéad íomhá a ghiniúint leis an API Grok
  2. Struchtúr Iarratais Giniúna
  3. Paraiméadair an Iarratais
  4. Formáid na Freagartha
  5. Cleachtas Praicticiúil
  6. Príomhphointí

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_ratio socraithe go auto, resolution go 1k), paraiméadar quality do 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

Íomhá arna giniúint ag 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.

1
Pointe Deiridh Giniúna
2
Samhlacha atá ar Fáil
10
Uasmhéid Íomhánna in aghaidh an Iarratais
2k
Uas-Taifeach

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-image nó grok-imagine-image-2.0, féach ceacht 2)
  • prompt: an cur síos téacsúil ar an íomhá atá uait
  • n: líon na n-íomhánna le giniúint (1 go 10, réamhshocrú: 1)
  • aspect_ratio: cóimheas gnéithe na híomhá (auto de réir réamhshocraithe: roghnaíonn an tsamhail bunaithe ar an leid)
  • resolution: an taifeach (1k de réir réamhshocraithe, nó 2k)
  • quality: low, medium, nó auto (réamhshocrú) ar Imagine 2.0, féach ceacht 12
  • response_format: url (réamhshocrú) nó b64_json chun 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_format socraithe ar url)
  • b64_json: na sonraí Base64 den íomhá (má tá response_format socraithe ar b64_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ú: model agus prompt
  • 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ú) agus 2k na taifigh atá ar fáil