Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Eindpunten ondersteund in batches

Les 3 van 12 Bijgewerkt op 2 november 2026 Ontwikkelaar
Op deze pagina
  1. Zeven eindpunten, één workflow
  2. Teksteindpunten
  3. Afbeeldingseindpunten
  4. Video-eindpunten
  5. Eindpunten mixen in een batch
  6. Het juiste eindpunt kiezen
  7. Belangrijkste punten

Bijgewerkt op 2 november 2026, gebaseerd op de documentatie van xAI: de batchkorting bedraagt 20% op in aanmerking komende tekstmodellen (niet 50%), de voorbeelden volgen de REST API en de officiële xai-sdk (client.batch.*; de Batch API van xAI gebruikt niet het formaat van OpenAI, dus de OpenAI SDK is niet van toepassing), en de Responses API heeft voorrang boven Chat Completions, een verouderd eindpunt bij xAI. Bronnen: Batch API · REST-referentie · Batch-prijzen.

Zeven eindpunten, één workflow

De Batch API beperkt zich niet tot tekstgeneratie. Het accepteert zeven eindpunten die tekst, afbeeldingen en video bestrijken. U kunt deze binnen één batch mixen om complete multimodale pipelines in één bewerking op te bouwen.

Teksteindpunten

/v1/responses — De Responses API, die door xAI wordt aanbevolen. Deze geeft u toegang tot server-side tools (webzoekopdrachten, X-zoekopdrachten, code-uitvoering, MCP), function calling en gestructureerde uitvoer, en ontvangt als eerste nieuwe functies.

/v1/chat/completions — Het oorspronkelijke completion-eindpunt, in het formaat van OpenAI. xAI behoudt dit als een verouderd eindpunt: het is nog steeds nuttig voor bestaande code die hierop is geschreven, maar voor een nieuwe pipeline kunt u beter beginnen met Responses.

Op in aanmerking komende modellen geldt de batchkorting van 20% voor beide eindpunten, voor alle tokentypes.

Afbeeldingseindpunten

/v1/images/generations — Genereert afbeeldingen op basis van een prompt. De parameters die u gebruikt zijn aspect_ratio (bijvoorbeeld "16:9"), resolution ("1k", "1.5k" of "2k"), n voor het aantal afbeeldingen en response_format ("url" of "b64_json").

/v1/images/edits — Bewerkt een bestaande afbeelding, gespecificeerd door een image-object dat een url (een openbaar adres of base64-gecodeerde gegevens) of de file_id van een geüpload bestand bevat. Handig voor het serieel uitvoeren van transformaties op een visuele catalogus.

Afbeeldingen worden gefactureerd tegen het standaardtarief, zonder batchkorting: hier ligt de waarde van batching in de operationele efficiëntie, niet in de financiële voordelen.

Video-eindpunten

/v1/videos/generations (of /v1/videos) — Genereert video’s op basis van een prompt, met een lengte van 1 tot 15 seconden (duration, standaard 8), in 480p, 720p of 1080p.

/v1/videos/edits — Bewerkt een bestaande video, doorgegeven in een video-object (de URL van een .mp4-bestand of een file_id).

/v1/videos/extensions — Breidt een video uit met een nieuw segment van 2 tot 10 seconden.

Net als bij afbeeldingen blijft de videoprijsstelling in de batchmodus op het standaardtarief. Resultaten voor afbeeldingen en video’s worden teruggegeven als ondertekende URL’s die na één uur verlopen.

Eindpunten mixen in een batch

In een JSONL-bestand specificeert elke regel zijn eindpunt in het veld 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"}}

Op deze manier kunt u uw productbeschrijvingen en de bijbehorende visualisaties in dezelfde batch genereren.

Het juiste eindpunt kiezen

  • Responses: de standaardkeuze, essentieel zodra u server-side tools, gestructureerde uitvoer of de nieuwste functies nodig hebt
  • Chat Completions: continuïteit voor code die reeds is geschreven in het Chat Completions-formaat, en niets meer dan dat
  • Afbeeldingen en video: voor het serieel produceren van visualisaties, met de wetenschap dat hierop geen korting geldt

Belangrijkste punten

  • Zeven eindpunten worden geaccepteerd: twee voor tekst, twee voor afbeeldingen, drie voor video
  • Responses is het aanbevolen eindpunt; Chat Completions is een verouderd eindpunt bij xAI
  • Alleen tokens op in aanmerking komende tekstmodellen komen in aanmerking voor de korting van 20%
  • Het veld url van elke JSONL-regel bepaalt het doeleindpunt en eindpunten kunnen binnen een batch worden gemixt
  • Resultaten voor afbeeldingen en video’s zijn ondertekende URL’s die één uur geldig zijn