Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Leeren Batch erstellen

Lektion 4 von 12 Aktualisiert am 2. November 2026 Entwickler
Auf dieser Seite
  1. Erster Schritt: Initialisierung
  2. Der Create-Aufruf
  3. Python-Implementierung
  4. JavaScript-Implementierung
  5. Grenzwerte für die Batch-Erstellung
  6. Best Practices
  7. Kernaussagen

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

1

POST /v1/batches

Erstellt einen benannten Batch und gibt dessen batch_id zurück.

2

Die batch_id speichern

Speichern Sie die Kennung für spätere Operationen.

3

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 Feld name ist
  • Die Antwort enthält eine eindeutige batch_id, die für den Rest des Workflows gespeichert werden muss
  • In Python stellt das offizielle xai-sdk SDK client.batch.create(batch_name=...) bereit
  • Der Grenzwert beträgt 2 Erstellungen pro Sekunde pro Team, ohne Deckelung der Batch-Anzahl
  • Achten Sie auf expire_time und wiederholen Sie nur vorübergehende Fehler