Leeren Batch erstellen
Auf dieser Seite
Aktualisiert am 2. November 2026 basierend auf der xAI-Dokumentation: Der Batch-Rabatt beträgt 20 % für berechtigte Textmodelle (nicht 50 %), die Beispiele verwenden die REST-API und das offizielle
xai-sdkSDK (client.batch.*; die Batch-API von xAI verwendet kein OpenAI-Format, sodass das OpenAI SDK nicht anwendbar ist), und die Responses API geht der Chat Completions vor, einem Legacy-Endpunkt bei xAI. Quellen: Batch API · REST-Referenz · Batch-Preise.
Erster Schritt: Initialisierung
Die Erstellung eines Batches ist die erste konkrete Aktion in Ihrem Workflow. Ein POST /v1/batches-Aufruf initialisiert einen leeren Container, der Ihre Anfragen dann empfängt. Dieser Schritt ist absichtlich minimal: Er erstellt die Kennung und bereitet den Batch auf der Serverseite vor.
POST /v1/batches
Erstellt einen benannten Batch und gibt dessen batch_id zurück.
Die batch_id speichern
Speichern Sie die Kennung für spätere Operationen.
Die Anfragen hinzufügen
Der Batch ist bereit, Anfragen über die API zu empfangen.
Der Create-Aufruf
Der Anforderungskörper enthält nur ein erforderliches Feld, 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"}'
Die Antwort enthält die batch_id, die Erstellungs- und Ablaufdaten sowie die Batch-Zähler, die noch bei null stehen (Beispiel aus der API-Referenz):
{
"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-Implementierung
Das offizielle SDK wird mit pip install xai-sdk installiert (Version 1.21.0 zum Zeitpunkt des 2. November 2026; Minimum Python 3.10). Es liest den Schlüssel aus der Umgebungsvariablen 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 erstellt: {batch_id}")
Die zurückgegebene batch_id ist der eindeutige Referenzpunkt für Ihren Batch. Bewahren Sie ihn in einer Variablen, einer Datei oder einer Datenbank auf, je nach Ihrer Architektur.
JavaScript-Implementierung
Ohne SDK reicht ein einfacher fetch-Aufruf an die 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 erstellt: ${batch.batch_id}`);
Grenzwerte für die Batch-Erstellung
Die Batch-Erstellung ist auf 2 pro Sekunde pro Team begrenzt; die Anzahl der Batches selbst ist nicht gedeckelt. In der Praxis werden Sie diesen Grenzwert selten erreichen: Sie erstellen in der Regel pro Operation einen Batch und fügen dann alle Ihre Anfragen hinzu. Wenn Sie mehrere in einer Schleife erstellen, lassen Sie die Aufrufe mindestens 500 Millisekunden voneinander entfernt.
Best Practices
Bennen Sie Ihre Batches sorgfältig: Der Name ist erforderlich, machen Sie ihn daher aussagekräftig. Ein Name, der den Datensatz und das Datum angibt (customer_reviews_2026_11_02), ist in der Batch-Liste und in der xAI-Konsole leicht zu finden, was Ihnen auch eine visuelle Verfolgung der Batches ermöglicht.
Achten Sie auf die Ablaufzeit: expire_time gibt an, wann der Batch und seine Ergebnisse nicht mehr zugänglich sind. Ihr Abrufprozess muss vor diesem Zeitpunkt ablaufen.
Behandeln Sie Erstellungsfehler: Ein Authentifizierungsfehler, ein Grenzwertüberschreitung oder ein Netzwerkproblem können die Erstellung verhindern. Wiederholen Sie vorübergehende Fehler mit zunehmender Verzögerung (exponentielles Backoff), wiederholen Sie aber niemals Authentifizierungsfehler.
Kernaussagen
- Die Erstellung eines Batches ist ein
POST /v1/batches, dessen einziges erforderliches Feldnameist - Die Antwort enthält eine eindeutige
batch_id, die für den Rest des Workflows gespeichert werden muss - In Python stellt das offizielle
xai-sdkSDKclient.batch.create(batch_name=...)bereit - Der Grenzwert beträgt 2 Erstellungen pro Sekunde pro Team, ohne Deckelung der Batch-Anzahl
- Achten Sie auf
expire_timeund wiederholen Sie nur vorübergehende Fehler