Opret en tom batch
På denne side
Opdateret 2. november 2026 baseret på xAI-dokumentation: batch-rabatten er 20 % på berettigede tekstmodeller (ikke 50 %), eksemplerne bruger REST API’et og det officielle
xai-sdkSDK (client.batch.*; xAI’s Batch API bruger ikke OpenAI-formatet, så OpenAI SDK gælder ikke), og Responses API har forrang frem for Chat Completions, som er et forældet endpoint hos xAI. Kilder: Batch API · REST-reference · Batch-prissætning.
Første trin: Initialisering
At oprette en batch er den første konkrete handling i din workflow. Et POST /v1/batches-kald initialiserer en tom beholder, der derefter modtager dine anmodninger. Dette trin er bevidst minimalt: det opretter identifikatoren og klargør batchen på serversiden.
POST /v1/batches
Opretter en navngivet batch og returnerer dens batch_id.
Gem batch_id
Gem identifikatoren til senere operationer.
Tilføj anmodningerne
Batchen er klar til at modtage anmodninger via API'et.
Oprettelseskaldet
Brødteksten i anmodningen indeholder kun ét påkrævet felt, name:
curl -X POST https://api.x.ai/v1/batches \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "customer_review_analysis"}'
Svaret indeholder batch_id, oprettelses- og udløbsdatoer samt batch-tællere, der stadig står på nul (eksempel fra API-referencen):
{
"batch_id": "batch_1934e8b5-f3dc-45f1-8329-9841b0aee9d8",
"name": "customer_review_analysis",
"create_time": "2025-11-11",
"expire_time": "2025-11-12",
"create_api_key_id": "********-****-****-****-************",
"cancel_time": null,
"cancel_by_xai_message": null,
"state": {
"num_requests": 0,
"num_pending": 0,
"num_success": 0,
"num_error": 0,
"num_cancelled": 0
}
}
Python-implementering
Det officielle SDK installeres med pip install xai-sdk (version 1.21.0 pr. 2. november 2026; minimum Python 3.10). Det læser nøglen fra miljøvariablen XAI_API_KEY:
from xai_sdk import Client
client = Client()
batch = client.batch.create(batch_name="customer_review_analysis")
batch_id = batch.batch_id
print(f"Batch created: {batch_id}")
Det returnerede batch_id er den unikke reference til din batch. Gem det i en variabel, en fil eller en database afhængigt af din arkitektur.
JavaScript-implementering
Uden et SDK er et simpelt fetch til REST API’et nok:
const response = await fetch("https://api.x.ai/v1/batches", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.XAI_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({ name: "customer_review_analysis" })
});
const batch = await response.json();
console.log(`Batch created: ${batch.batch_id}`);
Hastighedsbegrænsninger for oprettelse
Oprettelse af batch er begrænset til 2 pr. sekund pr. team; selve antallet af batcher er ikke begrænset. I praksis vil du sjældent ramme denne grænse: du opretter typisk én batch pr. operation og tilføjer derefter alle dine anmodninger til den. Hvis du opretter flere i en løkke, skal du sprede kaldene med mindst 500 millisekunders mellemrum.
Bedste praksis
Navngiv dine batcher omhyggeligt: Navnet er påkrævet, så sørg for, at det er nyttigt. Et navn, der angiver datasættet og datoen (customer_reviews_2026_11_02), er let at finde på batch-listen og i xAI-konsollen, som også giver dig mulighed for at spore batcher visuelt.
Bemærk udløbstidspunktet: expire_time angiver, hvornår batchen og dens resultater ophører med at være tilgængelige. Din henteproces skal køre før dette tidspunkt.
Håndtér oprettelsesfejl: En autentificeringsfejl, overskridelse af hastighedsbegrænsningen eller et netværksproblem kan forhindre oprettelse. Genforsøg forbigående fejl med en stigende forsinkelse (eksponentiel backoff), men genforsøg aldrig autentificeringsfejl.
Vigtige pointer
- At oprette en batch er et
POST /v1/batches, hvor det eneste påkrævede felt ername - Svaret indeholder en unik
batch_id, som du skal gemme til resten af workflowet - I Python eksponerer det officielle
xai-sdkSDK metodenclient.batch.create(batch_name=...) - Grænsen er 2 oprettelser pr. sekund pr. team, uden loft over antallet af batcher
- Hold øje med
expire_timeog genforsøg kun forbigående fejl