Slutpunkter som stöds i batchar
På denna sida
Uppdaterat 2 november 2026, baserat på xAI:s dokumentation: batch-rabatten är 20 % på berättigade textmodeller (inte 50 %), exemplen följer REST API:t och den officiella
xai-sdk(client.batch.*; xAI:s Batch API använder inte OpenAIs format, så OpenAI SDK 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.
Sju slutpunkter, ett arbetsflöde
Batch API:t är inte begränsat till textgenerering. Det accepterar sju slutpunkter som täcker text, bilder och video, och du kan blanda dem i en enda batch för att bygga kompletta multimodala pipeline i en enda operation.
Textslutpunkter
/v1/responses — Responses API, den som xAI rekommenderar. Den ger dig tillgång till server-side-verktyg (webbsökning, X-sökning, kodexekvering, MCP), funktionsanrop och strukturerade utdata, och den får nya funktioner först.
/v1/chat/completions — Den ursprungliga kompletteringsslutpunkten, i OpenAIs format. xAI behåller den som en föråldrad slutpunkt: den är fortfarande användbar för befintlig kod som skrivits mot den, men en ny pipeline har bättre av att börja med Responses.
På berättigade modeller gäller batch-rabatten på 20 % för båda slutpunkterna, över alla tokentyper.
Bildslutpunkter
/v1/images/generations — Genererar bilder från en prompt. De parametrar du kommer att använda är aspect_ratio (till exempel "16:9"), resolution ("1k", "1.5k" eller "2k"), n för antalet bilder och response_format ("url" eller "b64_json").
/v1/images/edits — Redigerar en befintlig bild, specificerad av ett image-objekt som innehåller en url (en offentlig adress eller base64-kodad data) eller file_id för en uppladdad fil. Användbart för att köra transformationer i serie över en visuell katalog.
Bilder debiteras till standardpriset utan batch-rabatt: här är värdet av batching operativt, inte ekonomiskt.
Videoslutpunkter
/v1/videos/generations (eller /v1/videos) — Genererar videor från en prompt, från 1 till 15 sekunder långa (duration, 8 som standard), vid 480p, 720p eller 1080p.
/v1/videos/edits — Redigerar en befintlig video, skickad i ett video-objekt (URL:en till en .mp4-fil eller ett file_id).
/v1/videos/extensions — Förlänger en video med ett nytt segment på 2 till 10 sekunder.
Precis som för bilder ligger videopriserna kvar på standardnivå i batch-läge. Resultat för bilder och videor returneras som signerade URL:er som upphör att gälla efter en timme.
Blanda slutpunkter i en batch
I en JSONL-fil anger varje rad sin slutpunkt i fältet url:
{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Summarize this article: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a neighborhood bookstore"}}
På detta sätt kan du generera dina produktbeskrivningar och deras visuella element i samma batch.
Välja rätt slutpunkt
- Responses: standardvalet, nödvändigt så snart du behöver server-side-verktyg, strukturerade utdata eller de nyaste funktionerna
- Chat Completions: kontinuitet för kod som redan skrivits i Chat Completions-formatet, och inget mer
- Bilder och video: för att producera visuellt innehåll i serie, med tanke på att de inte får någon rabatt
Viktiga punkter
- Sju slutpunkter accepteras: två för text, två för bilder, tre för video
- Responses är den rekommenderade slutpunkten; Chat Completions är en föråldrad slutpunkt hos xAI
- Endast tokens på berättigade textmodeller får 20 % rabatt
- Fältet
urli varje JSONL-rad avgör målslutpunkten, och slutpunkter kan blandas inom en batch - Resultat för bilder och videor är signerade URL:er giltiga i en timme