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

Íomhánna agus Físeáin i mBaitcheanna

Ceacht 9 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Giniúint Ilmhóideach Bulc
  2. Giniúint Íomhánna i mBaitcheanna
  3. Eagarthóireacht Íomhánna i mBaitcheanna
  4. Giniúint Físeán i mBaitcheanna
  5. Eagarthóireacht agus Síneadh Físeán
  6. An Python SDK a Úsáid
  7. Praghsáil Ábhair Ilmhóidigh
  8. Éag na nURL Torthaí
  9. Píblíne Ilmhóideach Measctha
  10. Príomhphointí

Nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú xAI: tá lascaine 20% ar fáil ar mhúnlaí téacs incháilithe (ní 50%), leanann na samplaí an REST API agus an xai-sdk oifigiúil (client.batch.*; ní úsáideann xAI Batch API formáid OpenAI, ní bhaineann an OpenAI SDK leis), agus tá tosaíocht ag an Responses API ar Chat Completions, atá ina phointe deiridh sinsearach ag xAI. Foinse: Batch API · REST Reference · Batch Pricing.

Giniúint Ilmhóideach Bulc

Níl an Batch API teoranta do théacs amháin. Is féidir leat giniúint agus eagarthóireacht íomhánna, chomh maith le giniúint, eagarthóireacht agus síneadh físeán a chur isteach. Osclaíonn an cumas seo an doras do phíblínte ilmhóideacha iomlána: scríobh cur síosanna agus táirg a n-íomhánna in oibríocht amháin.

Giniúint Íomhánna i mBaitcheanna

Oibríonn an pointe deiridh /v1/images/generations i mbaitche díreach mar a dhéanann sé sa mhód comhthreomhar. Roghnaigh an formáid le aspect_ratio, an sainmhíniú le resolution ("1k", "1.5k", nó "2k"), agus líon na n-íomhánna le n:

{"custom_id": "img-001", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a fintech startup, white background, vector style", "n": 1, "aspect_ratio": "1:1", "resolution": "1k"}}
{"custom_id": "img-002", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Isometric illustration of a datacenter", "n": 1, "aspect_ratio": "16:9", "resolution": "1k"}}

Eagarthóireacht Íomhánna i mBaitcheanna

Déanann an pointe deiridh /v1/images/edits modhnú ar íomhá atá ann cheana, a tharchuirtear in oibiacht image: url (seoladh poiblí nó sonraí ionchódaithe base64) nó file_id comhaid uaslódáilte.

{"custom_id": "edit-001", "method": "POST", "url": "/v1/images/edits", "body": {"model": "grok-imagine-image-2.0", "prompt": "Replace the background with a solid white background", "image": {"url": "https://example.com/photo.jpg"}}}

Sa mhód baitche, cabhraíonn eagarthóireacht le catalóg a phróiseáil: cúlraí a chomhchuibhiú, eilimint a chur leis, nó an t-aon athdhearadh céanna a chur i bhfeidhm ar na céadta íomhá.

Giniúint Físeán i mBaitcheanna

Giníonn an pointe deiridh /v1/videos/generations (nó /v1/videos) físeáin ó 1 go 15 soicind (duration, 8 mar réamhshocrú), i 480p, 720p, nó 1080p:

{"custom_id": "vid-001", "method": "POST", "url": "/v1/videos/generations", "body": {"model": "grok-imagine-video-1.5", "prompt": "Smooth animation of a bar chart growing progressively", "duration": 8, "resolution": "720p"}}

Tá próiseáil físeáin níos troime ná téacs nó íomhánna, mar sin d’fhéadfadh na hiarratais seo níos mó ama a ghlacadh laistigh den bhaitche.

Eagarthóireacht agus Síneadh Físeán

Déanann an pointe deiridh /v1/videos/edits modhnú ar fhíseán atá ann cheana, agus síneann /v1/videos/extensions é le mír 2 go 10 soicind. Cuir an físeán foinse ar fáil in oibiacht video (URL de chomhad .mp4, nó file_id):

{"custom_id": "vid-edit-001", "method": "POST", "url": "/v1/videos/edits", "body": {"model": "grok-imagine-video", "prompt": "Slow down the scene", "video": {"url": "https://example.com/clip.mp4"}}}
{"custom_id": "vid-ext-001", "method": "POST", "url": "/v1/videos/extensions", "body": {"model": "grok-imagine-video", "prompt": "The camera slowly pulls back and reveals a sunset", "video": {"url": "https://example.com/clip.mp4"}, "duration": 6}}

An Python SDK a Úsáid

Ullmhaíonn an SDK na hiarratais seo le modhanna tiomnaithe, agus ansin cuireann sé leis an mbaitche iad cosúil le hiarratais téacs:

from xai_sdk import Client

client = Client()
batch = client.batch.create(batch_name="catalog_visuals")

requetes = [
    client.image.prepare(
        prompt="Product shot of wireless headphones, dark background, studio lighting",
        model="grok-imagine-image-2.0",
        batch_request_id="prod-42-img",
    ),
    client.video.prepare(
        prompt="The headphones rotate slowly on a turntable, dramatic lighting",
        model="grok-imagine-video-1.5",
        batch_request_id="prod-42-vid",
    ),
]
client.batch.add(batch_id=batch.batch_id, batch_requests=requetes)

Praghsáil Ábhair Ilmhóidigh

Pointe tábhachtach: ní bhaineann an lascaine bhaitche ach le múnlaí téacs incháilithe. Billeáiltear íomhánna agus físeáin ag an gnáthráta, fiú sa mhód baitche—ó tháinig an 2 Samhain, 2026, $0.04 in aghaidh na híomhá le grok-imagine-image-2.0 ($0.02 le grok-imagine-image), agus $0.08 in aghaidh an tsoicind físeáin le grok-imagine-video-1.5 ($0.02 sa leagan -lite, $0.05 le grok-imagine-video).

Ní praghsáil atá i dtairbhe na mbaitcheanna d’ábhar ilmhóideach ach oibríochtúil: cuir na céadta giniúna isteach in oibríocht amháin, gan a oiread glaoch a bhainistiú nó teorainneacha ráta a bhualadh.

Éag na nURL Torthaí

Soláthraítear torthaí íomhánna agus físeán mar URLanna sínithe a éagann tar éis uaire amháin. Is srian criticiúil é seo: íoslódáil na comhaid chomh luath agus a fhaigheann tú na torthaí.

import mimetypes

import requests


def telecharger_medias(resultats, dossier):
    """Downloads images and videos as soon as results are retrieved."""
    for r in resultats:
        reponse = r.proto.response
        if reponse.HasField("image_response"):
            url = r.image_response.url
        elif reponse.HasField("video_response"):
            url = r.video_response.url
        else:
            continue  # text result
        fichier = requests.get(url, timeout=120)
        fichier.raise_for_status()
        type_mime = fichier.headers.get("Content-Type", "").split(";")[0]
        extension = mimetypes.guess_extension(type_mime) or ".bin"
        with open(f"{dossier}/{r.batch_request_id}{extension}", "wb") as f:
            f.write(fichier.content)

Ná stóráil URLanna sínithe riamh le haghaidh úsáide ina dhiaidh sin: sábháil na comhaid i do stóras féin (S3, GCS, diosca logánta).

Píblíne Ilmhóideach Measctha

Cás úsáide concreideach: táirg bileoga táirge iomlána, téacs agus amharc, sa bhaitche céanna:

{"custom_id": "prod-42-desc", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": "Write a marketing description for a high-end wireless headphone.", "max_output_tokens": 300}}
{"custom_id": "prod-42-img", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Product shot of premium wireless headphones, dark gradient background, studio lighting"}}

Déanann réimír coiteann sna aitheantóirí (prod-42-desc, prod-42-img) éasca grúpáil a dhéanamh ar thorthaí téacs agus íomhá don táirge céanna.

Príomhphointí

  • Oibríonn íomhánna (giniúint, eagarthóireacht) agus físeáin (giniúint, eagarthóireacht, síneadh) i mbaitcheanna
  • Meaitseálann paraiméadair an API: aspect_ratio, resolution, oibiachtaí image agus video
  • Fanann íomhánna agus físeáin ag gnáthrátaí, gan lascainí baitche
  • Éagaíonn URLanna torthaí sínithe tar éis uair amháin: íoslódáil láithreach
  • Grúpálann réimír coiteann in aitheantóirí torthaí don táirge céanna