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

Iarratais a Chur le JSON

Ceacht 5 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Cur leis tríd an API
  2. Struchtúr an Iarrtais
  3. Iarratas cURL
  4. Cur leis leis an Python SDK
  5. Teorainneacha Ráta ar Chur leis
  6. Cathin Úsáid a Bhaint as Cur leis tríd an API
  7. Bailíochtú Iarratais
  8. Príomhphointí

Nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú xAI: tá lascaine 20% ar fáil do 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 Batch API xAI formáid OpenAI, agus ní bhaineann SDK OpenAI leis), agus tá tosaíocht ag an Responses API ar Chat Completions, atá ina phointe deiridh leagtha amach ag xAI. Foinse: Batch API · Tagairt REST · Praghsáil Batch.

Cur leis tríd an API

Nuair a chruthaítear an baisc, cuireann tú iarratais leis trí POST /v1/batches/{batch_id}/requests. Iompraíonn gach glaó liosta d’iarratais, agus is féidir leat an pointe deiridh a ghlaó chomh minic agus is gá fad nach gcuirtear an baisc ar ceal. Oibríonn an cur chuige seo do bhaisceanna a thógtar de réir a chéile.

Struchtúr an Iarrtais

Tá eagair batch_requests i gcorp an ghlao. Péireálann gach eilimint aitheantóir (batch_request_id) leis an iarratas féin, atá stóráilte faoin eochair a bhaineann lena chineál—responses don Responses API:

{
  "batch_requests": [
    {
      "batch_request_id": "avis-001",
      "batch_request": {
        "responses": {
          "model": "grok-4.3",
          "input": [
            {"role": "system", "content": "Classify the sentiment: positive, negative, or neutral."},
            {"role": "user", "content": "The product exceeded my expectations!"}
          ]
        }
      }
    }
  ]
}
  • batch_request_id: Do aitheantóir féin, atá uathúil laistigh den bhaisc. Is é seo an eochair a mheaitseálann an t-iarratas lena thoradh; mura bhfuil sé ann, gineann xAI UUID.
  • batch_request: An t-iarratas, faoin eochair a bhaineann lena chineál; déanann an tagairt API doiciméadú ar chat_get_completion don fhormáid Chat Completions freisin.

Chun íomhánna agus físeáin a úsáid, bain úsáid as an SDK (ceacht 9) nó as comhad JSONL (an chéad cheacht eile).

Iarratas cURL

curl -X POST "https://api.x.ai/v1/batches/$BATCH_ID/requests" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "batch_requests": [
      {
        "batch_request_id": "article-42",
        "batch_request": {
          "responses": {
            "model": "grok-4.3",
            "input": [
              {"role": "user", "content": "Classify this text: positive, neutral, or negative."}
            ]
          }
        }
      }
    ]
  }'

Cur leis leis an Python SDK

Leis an SDK, tógtar gach iarratas cosúil le comhrá caighdeánach, sannann tú batch_request_id dó, agus ansin cuireann tú iad leis i smutání:

from xai_sdk import Client
from xai_sdk.chat import system, user

client = Client()

documents = [
    {"id": "doc-1", "text": "First document to analyze..."},
    {"id": "doc-2", "text": "Second document to analyze..."},
    {"id": "doc-3", "text": "Third document to analyze..."},
]

batch_id = "batch_1934e8b5-f3dc-45f1-8329-9841b0aee9d8"

requests = []
for doc in documents:
    chat = client.chat.create(model="grok-4.3", batch_request_id=doc["id"])
    chat.append(system("Summarize the document in two sentences."))
    chat.append(user(doc["text"]))
    requests.append(chat)

# Cuir leis i smutání de 100: glaó API amháin in aghaidh an smután
for i in range(0, len(requests), 100):
    client.batch.add(batch_id=batch_id, batch_requests=requests[i:i + 100])

Ní shocraíonn an doiciméadú uasmhéid iarratais in aghaidh an ghlao; teorannaíonn méideanna measartha smutání ach an méid a chaithfear a athsheoladh i gcás teagmhais líonra.

Teorainneacha Ráta ar Chur leis

Is féidir le foireann suas le 1,000 glaó cur leis gach 30 soicind a dhéanamh, i bhfuinneog shleamhnáin a roinntear thar a bhaisceanna go léir. Baineann an teorainn le glaonna, ní le hiarratais: le smutání de 100 iarratas, cheadaíonn sé seo níos mó ná 3,000 iarratas in aghaidh an tsoicind cheana féin. Tá dhá theorainn eile níos tábhachtaí:

  • 25 MB mar uasmhéid in aghaidh gach iarrtais aonair, rud a bhaineann go príomha le híomhánna atá ionchódaithe i mbonn64
  • Thar 100,000 iarratas i mbaisc, d’fhéadfadh xAI moilliú a chur ar an bpróiseáil chun cobhsaíocht na seirbhíse a chaomhnú

Cathin Úsáid a Bhaint as Cur leis tríd an API

Oibríonn cur leis tríd an API nuair a bhíonn solúbthacht níos tábhachtaí ná ullmhúchán roimh ré. Éiríonn sé ina rogha nádúrtha nuair a thógtar an baisc de réir a chéile: cuirtear iarratais a thagann ó chiú leis de réir mar a thagann siad, agus d’éileodh comhad JSONL gach rud a bheith ar eolas roimh ré—agus dhúnfadh sé an bhaisc. Is é an bealach é freisin le haghaidh prótatípaithe, chun an sruth oibre iomlán a thástáil le cúig iarratas sula ndéantar scálú, agus le haghaidh baisceanna ilchineálacha.

Bailíochtú Iarratais

Seiceáil cód stádais gach glao cur leis: ciallaíonn earráid ag an gcéim seo nach bhfuil an smután sábháilte, agus caithfidh tú é a athsheoladh. Féadfaidh iarratas teip ina dhiaidh sin freisin, le linn próiseála; ansin feictear é sna torthaí lena theachtaireacht earráide. Diúltaítear do mhúnla nach nglacann leis an mbaisc leis an teachtaireacht not supported for batch processing: seiceáil incháilitheacht ar leathanach an mhúnla sula seolann tú baisc mhór.

Príomhphointí

  • Téann cur leis trí POST /v1/batches/{id}/requests, le liosta batch_requests
  • Iompraíonn gach iarratas batch_request_id uathúil agus a chuid ábhair faoin eochair a bhaineann lena chineál (responses, chat_get_completion)
  • Tógann an SDK iarratais le client.chat.create(..., batch_request_id=...) agus cuireann sé leis iad le client.batch.add
  • Is é an teorainn ná 1,000 glaó cur leis in aghaidh gach 30 soicind don fhoireann; is féidir go leor iarratais a bheith i ngach glaó
  • Murab ionann agus an comhad JSONL, fágann cur leis tríd an API an bhaisc oscailte do chuir leis nua