In Batches unterstützte Endpunkte
Auf dieser Seite
Aktualisiert am 2. November 2026, basierend auf der Dokumentation von xAI: Der Batch-Rabatt beträgt 20 % für berechtigte Textmodelle (nicht 50 %). Die Beispiele folgen dem REST-API-Standard und dem offiziellen
xai-sdk(client.batch.*). Die Batch-API von xAI verwendet kein OpenAI-Format, sodass das OpenAI-SDK nicht anwendbar ist. Die Responses API hat Vorrang vor Chat Completions, einem veralteten Endpunkt bei xAI. Quellen: Batch API · REST-Referenz · Batch-Preise.
Sieben Endpunkte, ein Workflow
Die Batch-API beschränkt sich nicht auf Textgenerierung. Sie akzeptiert sieben Endpunkte für Text, Bilder und Videos, und Sie können sie in einer einzigen Batch mischen, um vollständige multimodale Pipelines in einem einzigen Vorgang zu erstellen.
Text-Endpunkte
/v1/responses — Die Responses API, den Endpunkt, den xAI empfiehlt. Er bietet Ihnen Zugriff auf serverseitige Tools (Web-Suche, X-Suche, Codeausführung, MCP), Funktionsaufrufe und strukturierte Ausgaben und erhält neue Funktionen zuerst.
/v1/chat/completions — Der ursprüngliche Completion-Endpunkt im OpenAI-Format. xAI hält ihn als veralteten Endpunkt aufrecht: Er ist für bestehenden Code, der darauf geschrieben wurde, weiterhin nützlich, aber für neue Pipelines ist es besser, mit Responses zu beginnen.
Bei berechtigen Modellen gilt der 20 %ige Batch-Rabatt für beide Endpunkte über alle Token-Typen hinweg.
Bild-Endpunkte
/v1/images/generations — Generiert Bilder aus einem Prompt. Die von Ihnen zu verwendenden Parameter sind aspect_ratio (beispielsweise "16:9"), resolution ("1k", "1.5k" oder "2k"), n für die Anzahl der Bilder und response_format ("url" oder "b64_json").
/v1/images/edits — Bearbeitet ein bestehendes Bild, das durch ein image-Objekt spezifiziert wird, das eine url (eine öffentliche Adresse oder base64-kodierte Daten) oder die file_id eines hochgeladenen Datei enthält. Nützlich für das sequenzielle Ausführen von Transformationen über einen visuellen Katalog hinweg.
Bilder werden zum Standardtarif abgerechnet; es gibt keinen Batch-Rabatt: Hier ist der Wert der Batch-Verarbeitung operativ, nicht finanziell.
Video-Endpunkte
/v1/videos/generations (oder /v1/videos) — Generiert Videos aus einem Prompt, mit einer Länge von 1 bis 15 Sekunden (duration, standardmäßig 8), in der Auflösung 480p, 720p oder 1080p.
/v1/videos/edits — Bearbeitet ein bestehendes Video, das in einem video-Objekt übergeben wird (die URL einer .mp4-Datei oder eine file_id).
/v1/videos/extensions — Erstreckt ein Video um einen neuen Abschnitt von 2 bis 10 Sekunden.
Wie bei Bildern bleibt die Video-Preiskalkulation im Batch-Modus beim Standardtarif. Bild- und Videergebnisse werden als signierte URLs zurückgegeben, die nach einer Stunde ablaufen.
Endpunkte in einer Batch mischen
In einer JSONL-Datei benennt jede Zeile ihren Endpunkt im Feld url:
{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Fassen Sie diesen Artikel zusammen: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalistisches Logo für einen Nachbarschaftsbuchladen"}}
Auf diese Weise könnten Sie in derselben Batch Ihre Produktbeschreibungen und deren visuelle Darstellungen generieren.
Auswahl des richtigen Endpunkts
- Responses: Die Standardwahl, unverzichtbar, sobald Sie serverseitige Tools, strukturierte Ausgaben oder die neuesten Funktionen benötigen.
- Chat Completions: Kontinuität für Code, der bereits im Chat-Completions-Format geschrieben wurde, und nichts weiter.
- Bilder und Videos: Für die serienmäßige Erstellung visueller Inhalte, wobei zu beachten ist, dass sie keinen Rabatt erhalten.
Kernaussagen
- Es werden sieben Endpunkte akzeptiert: zwei für Text, zwei für Bilder und drei für Videos.
- Responses ist der empfohlene Endpunkt; Chat Completions ist ein veralteter Endpunkt bei xAI.
- Nur Tokens auf berechtigen Textmodellen erhalten den 20 %igen Rabatt.
- Das Feld
urljeder JSONL-Zeile bestimmt den Ziel-Endpunkt, und Endpunkte können innerhalb einer Batch gemischt werden. - Bild- und Videergebnisse sind signierte URLs, die eine Gültigkeitsdauer von einer Stunde haben.