Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Endpoints understøttet i batches

Lektion 3 af 12 Opdateret 2. november 2026 Udvikler
På denne side
  1. Syv endpoints, én workflow
  2. Tekst-endpoints
  3. Billed-endpoints
  4. Video-endpoints
  5. Blanding af endpoints i en batch
  6. Valg af det rigtige endpoint
  7. Vigtige pointer

Opdateret 2. november 2026 baseret på xAI’s dokumentation: batch-rabatten er på 20 % for berettigede tekstmodeller (ikke 50 %), eksemplerne følger REST API’en og den officielle xai-sdk (client.batch.*; xAI’s Batch API bruger ikke OpenAI’s format, så OpenAI SDK’en gælder ikke), og Responses API’en har forrang frem for Chat Completions, som er et forældet endpoint hos xAI. Kilder: Batch API · REST-reference · Batch-prissætning.

Syv endpoints, én workflow

Batch API’en er ikke begrænset til tekstgenerering. Den accepterer syv endpoints, der dækker tekst, billeder og video, og du kan blande dem i en enkelt batch for at bygge komplette multimodale pipelines i én operation.

Tekst-endpoints

/v1/responses — Responses API’en, som xAI anbefaler. Den giver dig adgang til server-side værktøjer (websøgning, X-søgning, kodeeksekvering, MCP), funktionskald og strukturerede outputs, og den får nye funktioner først.

/v1/chat/completions — Det oprindelige completions-endpoint i OpenAI’s format. xAI beholder det som et forældet endpoint: det er stadig nyttigt for eksisterende kode skrevet mod det, men en ny pipeline bør starte med Responses.

På berettigede modeller gælder batch-rabatten på 20 % for begge endpoints på tværs af alle tokentyper.

Billed-endpoints

/v1/images/generations — Genererer billeder ud fra en prompt. De parametre, du vil bruge, er aspect_ratio (f.eks. "16:9"), resolution ("1k", "1.5k" eller "2k"), n for antallet af billeder og response_format ("url" eller "b64_json").

/v1/images/edits — Redigerer et eksisterende billede, specificeret ved et image-objekt, der indeholder en url (en offentlig adresse eller base64-kodede data) eller file_id for en uploadet fil. Nyttigt til at køre transformationer i serie på tværs af et visuelt katalog.

Billeder faktureres til standardtaksten uden batch-rabat: her er værdien ved batching operationel, ikke finansiel.

Video-endpoints

/v1/videos/generations (eller /v1/videos) — Genererer videoer ud fra en prompt med en længde på 1 til 15 sekunder (duration, standard er 8) i opløsningerne 480p, 720p eller 1080p.

/v1/videos/edits — Redigerer en eksisterende video, der sendes i et video-objekt (URL’en til en .mp4-fil eller et file_id).

/v1/videos/extensions — Forlænger en video med et nyt segment på 2 til 10 sekunder.

Som med billeder forbliver videopriserne på standardtaksten i batch-tilstand. Resultater for billeder og video returneres som signerede URLs, der udløber efter én time.

Blanding af endpoints i en batch

I en JSONL-fil navngiver hver linje sit endpoint i feltet 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å denne måde kan du generere dine produktbeskrivelser og deres visuelle elementer i samme batch.

Valg af det rigtige endpoint

  • Responses: standardvalget, essentielt så snart du har brug for server-side værktøjer, strukturerede outputs eller de nyeste funktioner
  • Chat Completions: kontinuitet for kode, der allerede er skrevet i Chat Completions-formatet, og ikke andet
  • Billeder og video: til produktion af visuelle elementer i serie; husk på, at de ikke får nogen rabat

Vigtige pointer

  • Syv endpoints accepteres: to til tekst, to til billeder, tre til video
  • Responses er det anbefalede endpoint; Chat Completions er et forældet endpoint hos xAI
  • Kun tokens på berettigede tekstmodeller får rabatten på 20 %
  • Feltet url i hver JSONL-linje bestemmer mål-endpointet, og endpoints kan blandes inden for en batch
  • Resultater for billeder og video er signerede URLs, der er gyldige i én time