Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Skapa en tom batch

Lektion 4 av 12 Uppdaterad 2 november 2026 Utvecklare
På denna sida
  1. Första steget: initiering
  2. Skapandeanropet
  3. Implementering i Python
  4. Implementering i JavaScript
  5. Hastighetsbegränsningar vid skapande
  6. Bästa praxis
  7. Viktiga punkter

Uppdaterad 2 november 2026 baserat på xAI:s dokumentation: rabatten för batch är 20 % på berättigade textmodeller (inte 50 %), exemplen använder REST API:t och den officiella SDK:n xai-sdk (client.batch.*; xAI:s Batch API använder inte OpenAI:s format, så OpenAI SDK:n gäller inte), och Responses API har företräde framför Chat Completions, som är en föråldrad slutpunkt hos xAI. Källor: Batch API · REST-referens · Batch-prissättning.

Första steget: initiering

Att skapa en batch är den första konkreta åtgärden i ditt arbetsflöde. Ett anrop till POST /v1/batches initierar en tom behållare som sedan kommer att ta emot dina förfrågningar. Detta steg är avsiktligt minimalt: det skapar identifieraren och förbereder batchen på serversidan.

1

POST /v1/batches

Skapar en namngiven batch och returnerar dess batch_id.

2

Lagra batch_id

Spara identifieraren för senare operationer.

3

Lägg till förfrågningar

Batchen är redo att ta emot förfrågningar via API:t.

Skapandeanropet

Begärandekroppen innehåller endast ett obligatoriskt fält, 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 innehåller batch_id, datum för skapande och utgång, samt batch-räknare, som fortfarande står på noll (exempel från API-referensen):

{
  "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
  }
}

Implementering i Python

Den officiella SDK:n installeras med pip install xai-sdk (version 1.21.0 per den 2 november 2026; kräver minst Python 3.10). Den läser nyckeln från miljövariabeln 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 returnerade batch_id är den unika referensen för din batch. Spara det i en variabel, en fil eller en databas, beroende på din arkitektur.

Implementering i JavaScript

Utan en SDK räcker ett enkelt fetch-anrop till REST API:t:

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}`);

Hastighetsbegränsningar vid skapande

Skapande av batch är begränsat till 2 per sekund per team; själva antalet batchar är inte begränsat. I praktiken kommer du sällan att nå denna gräns: du skapar oftast en batch per operation och lägger sedan till alla dina förfrågningar i den. Om du skapar flera i en loop, låt det gå minst 500 millisekunder mellan anropen.

Bästa praxis

Namnge dina batchar noggrant: namnet är obligatoriskt, så se till att det är användbart. Ett namn som anger dataset och datum (customer_reviews_2026_11_02) är lätt att hitta i batch-listan och i xAI-konsolen, vilket också låter dig spåra batchar visuellt.

Notera utgångstiden: expire_time anger när batchen och dess resultat slutar vara tillgängliga. Din hämtningsprocess måste köras innan dess.

Hantera skapandefel: ett autentiseringsfel, överskridande av hastighetsbegränsning eller ett nätverksfel kan förhindra skapandet. Försök igen vid övergående fel med ökande fördröjning (exponentiell backoff), men försök aldrig igen vid autentiseringsfel.

Viktiga punkter

  • Att skapa en batch är ett POST /v1/batches där det enda obligatoriska fältet är name
  • Svaret innehåller ett unikt batch_id som du måste spara för resten av arbetsflödet
  • I Python exponerar den officiella SDK:n xai-sdk metoden client.batch.create(batch_name=...)
  • Gränsen är 2 skapanden per sekund per team, utan tak för antalet batchar
  • Håll koll på expire_time och försök endast igen vid övergående fel