Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Opret en tom batch

Lektion 4 af 12 Opdateret 2. november 2026 Udvikler
På denne side
  1. Første trin: Initialisering
  2. Oprettelseskaldet
  3. Python-implementering
  4. JavaScript-implementering
  5. Hastighedsbegrænsninger for oprettelse
  6. Bedste praksis
  7. Vigtige pointer

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-sdk SDK (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.

1

POST /v1/batches

Opretter en navngivet batch og returnerer dens batch_id.

2

Gem batch_id

Gem identifikatoren til senere operationer.

3

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 er name
  • Svaret indeholder en unik batch_id, som du skal gemme til resten af workflowet
  • I Python eksponerer det officielle xai-sdk SDK metoden client.batch.create(batch_name=...)
  • Grænsen er 2 oprettelser pr. sekund pr. team, uden loft over antallet af batcher
  • Hold øje med expire_time og genforsøg kun forbigående fejl