Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Slutpunkter som stöds i batchar

Lektion 3 av 12 Uppdaterad 2 november 2026 Utvecklare
På denna sida
  1. Sju slutpunkter, ett arbetsflöde
  2. Textslutpunkter
  3. Bildslutpunkter
  4. Videoslutpunkter
  5. Blanda slutpunkter i en batch
  6. Välja rätt slutpunkt
  7. Viktiga punkter

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 url i 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