Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Een lege batch maken

Les 4 van 12 Bijgewerkt op 2 november 2026 Ontwikkelaar
Op deze pagina
  1. Eerste stap: initialisatie
  2. De create-aanroep
  3. Python-implementatie
  4. JavaScript-implementatie
  5. Limieten voor creatiefrequentie
  6. Best practices
  7. Belangrijkste punten

Bijgewerkt op 2 november 2026 op basis van de xAI-documentatie: de batch-korting bedraagt 20% op in aanmerking komende tekstmodellen (niet 50%), de voorbeelden gebruiken de REST API en de officiële xai-sdk SDK (client.batch.*; de Batch API van xAI gebruikt niet het formaat van OpenAI, dus de OpenAI SDK is niet van toepassing), en de Responses API heeft voorrang boven Chat Completions, een verouderd eindpunt bij xAI. Bronnen: Batch API · REST-referentie · Batch-prijzen.

Eerste stap: initialisatie

Het maken van een batch is de eerste concrete actie in uw workflow. Een POST /v1/batches-aanroep initialiseert een lege container die vervolgens uw verzoeken zal ontvangen. Deze stap is bewust minimaal gehouden: deze maakt de identifier aan en bereidt de batch voor aan de serverzijde.

1

POST /v1/batches

Maakt een benoemde batch aan en retourneert de batch_id.

2

Sla de batch_id op

Bewaar de identifier voor latere bewerkingen.

3

Voeg de verzoeken toe

De batch is klaar om verzoeken via de API te ontvangen.

De create-aanroep

De request body bevat slechts één verplicht veld, 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"}'

Het antwoord bevat de batch_id, de aanmaak- en vervaldatums, en de batch-tellers, die nog op nul staan (voorbeeld uit de API-referentie):

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

De officiële SDK installeert u met pip install xai-sdk (versie 1.21.0 per 2 november 2026; minimaal Python 3.10). Deze leest de sleutel uit de omgevingsvariabele 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}")

De geretourneerde batch_id is de unieke referentie voor uw batch. Bewaar deze in een variabele, een bestand of een database, afhankelijk van uw architectuur.

JavaScript-implementatie

Zonder SDK volstaat een simpele fetch naar de REST API:

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

Limieten voor creatiefrequentie

Het maken van batches is beperkt tot 2 per seconde per team; het aantal batches zelf is niet begrensd. In de praktijk zult u deze limiet zelden bereiken: u maakt doorgaans één batch per bewerking aan en voegt vervolgens al uw verzoeken eraan toe. Als u er meerdere in een lus maakt, houd dan minimaal 500 milliseconden tussen de aanroepen.

Best practices

Geef uw batches zorgvuldig een naam: de naam is verplicht, maak er dus nuttig gebruik van. Een naam die de dataset en datum vermeldt (customer_reviews_2026_11_02) is eenvoudig terug te vinden in de batchlijst en in de xAI-console, waarmee u batches ook visueel kunt volgen.

Let op de vervaldatum: expire_time geeft aan wanneer de batch en de resultaten ervan niet meer toegankelijk zijn. Uw ophaalproces moet vóór dat moment plaatsvinden.

Afhandelen van creatiefouten: een authenticatiefout, het overschrijden van een tarieflimiet of een netwerkprobleem kan creatie voorkomen. Probeer tijdelijke fouten opnieuw met een toenemende vertraging (exponential backoff), maar probeer authenticatiefouten nooit opnieuw.

Belangrijkste punten

  • Het maken van een batch is een POST /v1/batches waarbij het enige verplichte veld name is
  • Het antwoord bevat een unieke batch_id die u voor de rest van de workflow moet bewaren
  • In Python biedt de officiële xai-sdk SDK toegang tot client.batch.create(batch_name=...)
  • De limiet is 2 creaties per seconde per team, zonder maximum voor het aantal batches
  • Houd expire_time in de gaten en probeer alleen tijdelijke fouten opnieuw