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

Píblíne iomlán ó thús go deireadh

Ceacht 7 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Na píosaí a chur le chéile
  2. Píblíne Python iomlán
  3. Píblíne cURL céim ar chéim
  4. Láimhseáil earráidí sa táirgeadh
  5. Barrfheabhsú costais
  6. Príomhphointí

An cúrsa nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú xAI: tá lascaine 20% ar mhúnlaí téacs incháilithe (ní 50%), leanann na samplaí an REST API agus an xai-sdk oifigiúil (client.batch.*; ní hionann formáid Batch API xAI agus formáid OpenAI, mar sin ní bhaineann an OpenAI SDK leis), agus tá an Responses API chun tosaigh ar Chat Completions, críochphointe sinsearach ag xAI. Foinse: Batch API · REST Reference · Batch Pricing.

Na píosaí a chur le chéile

Chumhdaigh na ceachtanna roimhe seo gach céim ar leithligh. Cuireann an ceacht seo le chéile iad chun píblíne iomlán a chruthú, ó ullmhú sonraí go próiseáil na dtorthaí. Beidh script agat faoi dheireadh is féidir leat a oiriúnú do do chás úsáide féin.

Píblíne Python iomlán

import json
import time

from xai_sdk import Client

client = Client()  # léitear an eochair ó XAI_API_KEY

# --- Céim 1: ullmhaigh na sonraí ---
documents = [
    {"id": f"doc-{i}", "text": f"Inneachar cáipéise {i}..."}
    for i in range(100)
]

# --- Céim 2: scríobh an comhad JSONL ---
with open("batch_requests.jsonl", "w", encoding="utf-8") as f:
    for doc in documents:
        ligne = {
            "custom_id": doc["id"],
            "method": "POST",
            "url": "/v1/responses",
            "body": {
                "model": "grok-4.3",
                "input": [
                    {"role": "system", "content": "Déan achoimre i dhá abairt."},
                    {"role": "user", "content": doc["text"]},
                ],
                "max_output_tokens": 200,
            },
        }
        f.write(json.dumps(ligne, ensure_ascii=False) + "\n")

# --- Céim 3: uaslódáil an comhad ---
with open("batch_requests.jsonl", "rb") as f:
    fichier = client.files.upload(f, filename="batch_requests.jsonl")

# --- Céim 4: cruthaigh an baisc ón gcomhad (tá sé séalaithe anois) ---
batch = client.batch.create(batch_name="resumes_documents", input_file_id=fichier.id)
print(f"Cruthaíodh Baisc: {batch.batch_id}")

# --- Céim 5: fan go mbeidh an phróiseáil críochnaithe ---
while True:
    batch = client.batch.get(batch_id=batch.batch_id)
    etat = batch.state
    if batch.cancel_by_xai_message:
        raise RuntimeError(f"Cealaíodh an Baisc ag xAI: {batch.cancel_by_xai_message}")
    if etat.num_requests > 0 and etat.num_pending == 0:
        break
    print(f"{etat.num_success + etat.num_error}/{etat.num_requests} iarratas próiseáilte")
    time.sleep(300)  # gach 5 nóiméad

# --- Céim 6: faigh torthaí, leathanach ar leathanach ---
resultats, echecs = {}, []
jeton = None
while True:
    page = client.batch.list_batch_results(
        batch_id=batch.batch_id, limit=100, pagination_token=jeton
    )
    for r in page.succeeded:
        resultats[r.batch_request_id] = r.response.content
    echecs.extend(page.failed)
    if page.pagination_token is None:
        break
    jeton = page.pagination_token

with open("batch_results.json", "w", encoding="utf-8") as f:
    json.dump(resultats, f, ensure_ascii=False, indent=2)

print(f"{len(resultats)} toradh, {len(echecs)} teip")
print("Costas iomlán: $%.4f" % (batch.cost_breakdown.total_cost_usd_ticks / 1e10))

Tá trí mhionsonra tábhachtach ann. Éilíonn an coinníoll stoptha num_requests > 0 toisc go léitear baisc a chruthaítear ó chomhad sa chúlra: díreach tar éis a chruthaithe, d’fhéadfadh go mbeadh a chuntaire ar fad fós nialasach. Léiríonn an réimse cancel_by_xai_message go ndearna xAI cealú, mar shampla mar gheall ar líne neamhbhailí. Agus sloinntear an costas i ticí, deich mbilliúnú cuid de dhollar.

Píblíne cURL céim ar chéim

Má fhearr leat an líne ordaithe, seo an leagan coibhéiseach cURL (ag baint úsáide as jq chun freagraí a léamh):

# 1. Uaslódáil an comhad JSONL
FILE_ID=$(curl -s -X POST https://api.x.ai/v1/files \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -F file="@batch_requests.jsonl" | jq -r '.id')
echo "Comhad: $FILE_ID"

# 2. Cruthaigh an baisc ón gcomhad
BATCH_ID=$(curl -s -X POST https://api.x.ai/v1/batches \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"name\": \"resumes_documents\", \"input_file_id\": \"$FILE_ID\"}" | jq -r '.batch_id')
echo "Baisc: $BATCH_ID"

# 3. Léigh na cuntaire
curl -s "https://api.x.ai/v1/batches/$BATCH_ID" \
  -H "Authorization: Bearer $XAI_API_KEY" | jq '.state'

# 4. Faigh an chéad leathanach torthaí
curl -s "https://api.x.ai/v1/batches/$BATCH_ID/results?limit=100" \
  -H "Authorization: Bearer $XAI_API_KEY" > results-page-1.json

Faigh leathanaigh ina dhiaidh sin trí &pagination_token=… a chur leis leis an luach a thugtar ar ais ag an leathanach roimhe.

Láimhseáil earráidí sa táirgeadh

Déanann píblíne láidir idirdhealú idir trí theaghlach earráidí:

Earráidí cur isteach: teipeann uaslódáil comhaid nó cruthú baisce. Déan iarracht arís ar earráidí sealadacha (teorainn ama, teorainn ráta, earráid freastalaí) le moill mhéadaitheach: 1 s, 2 s, 4 s, 8 s.

Earráidí próiseála: teipeann roinnt iarratas laistigh den bhaisc. Feictear iad in page.failed lena dteachtaireacht; athchuir iad, agus iad siúd amháin, i mbaisc nua.

Teorainn ama agus éag: tá an fhuinneog 24 uair an chloig táscach, ní ráthaithe. Is é an rud nach mbíonn trócaireach ná an t-éag (expire_time): tar éis na pointe seo, ní bhíonn rochtain ar thorthaí a thuilleadh. Faigh iad de réir mar a thagann siad isteach seachas iad go léir ag an deireadh.

# Iarratais theipthe: sainaithin iad chun iad a athchur i mbaisc nua
for r in echecs:
    print(f"Teip: {r.batch_request_id} — {r.error_message}")
a_relancer = {r.batch_request_id for r in echecs}

Barrfheabhsú costais

Carnann sábhálacha ar fud ceithre ghiarála. Roghnú múnla teacht ar dtús, an ceann is cumhachtaí i bhfad: ag an gnáthráta ón 2 Samhain, 2026, costálann grok-4.3 $1.25 in aghaidh an mhilliún tócan ionchuir agus $2.50 d’aschur, i gcomparáid le $2 agus $6 do grok-4.7 (leideanna faoi bhun 200,000 tócan). Maidir le haicmiú nó eastóscadh gearr, is minic a bhíonn an múnla éadrom leordhóthanach, agus baineann an lascaine baisce 20% leis an dá cheann. Fad na freagra teacht ina dhiaidh sin: coscaíonn max_output_tokens íoc as aschuir atá ró-fhada gan ghá – maidir le haicmiú, is leor cúpla tócan. Leideanna: sábhálann deich dtócan a bhaint as leid a athdhéantar 50,000 uair 500,000 tócan ionchuir. Ar deireadh, taisce: déanann xAI taisce go huathoibríoch ar thosacha iarratais chomhionanna, agus baineann an lascaine baisce freisin le tócan a sheachadtar ón taisce; mar sin, cuir treoracha coitianta ag tús gach iarratais, roimh an chuid athraitheach.

Príomhphointí

  • Clúdaíonn píblíne iomlán sé chéim: ullmhú, JSONL, uaslódáil, cruthú, faireachán, aisghabháil
  • Léitear baisc ó chomhad sa chúlra: fan go mbeidh num_requests > 0 sula gconclúid tú go bhfuil sé críochnaithe
  • Láimhseáil na trí theaghlach earráidí: cur isteach, próiseáil, teorainn ama agus éag
  • Faigh agus sábháil torthaí de réir mar a thagann siad isteach, roimh expire_time
  • Uasmhéadaíonn roghnú múnla, fad aschuir, leideanna gairide, agus réamhtheachtaí coitianta na sábhálacha