Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Compatibiliteit met de OpenAI SDK

Les 6 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Multi-agent gebruiken via de OpenAI SDK
  2. Clientconfiguratie
  3. Aantal agents regelen met reasoning.effort
  4. De toewijzing van inspanning naar agents
  5. Chat Completions wordt niet ondersteund
  6. Streaming met de OpenAI SDK
  7. Voordelen en beperkingen van deze aanpak
  8. Belangrijkste punten

Multi-agent gebruiken via de OpenAI SDK

Veel teams hebben hun aanroep-laag al gebouwd rond de OpenAI SDK, inclusief de wrappers, tests en logconventies. Het goede nieuws: toegang krijgen tot de multi-agent-modus van Grok dwingt u niet alles opnieuw te schrijven. xAI biedt een API die compatibel is met het Responses-formaat van OpenAI, zodat u de OpenAI-client kunt behouden en deze eenvoudig naar de xAI-API kunt laten wijzen.

Clientconfiguratie

Twee instellingen volstaan: de basis-URL van xAI en uw xAI-API-sleutel.

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

Vervolgens gebruikt u de Responses API zoals gebruikelijk, waarbij u grok-4.20-multi-agent-0309 opgeeft als model. De rest van uw aanroepcode blijft ongewijzigd.

Aantal agents regelen met reasoning.effort

Hier vindt de vertaling tussen de twee werelden plaats. Waar de xAI SDK een expliciete agent_count biedt, kent de OpenAI SDK alleen reasoning.effort. U vraagt dus geen aantal agents aan, maar een inspanningsniveau dat xAI omzet in een aantal agents.

# 4 agents (lage inspanning)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "What are the latest open source models from 2026?"}],
)
print(response.output_text)
# 16 agents (hoge inspanning)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "high"},
    input=[{"role": "user", "content": "Compare the EU and US AI strategies in 2026"}],
)
print(response.output_text)

De toewijzing van inspanning naar agents

Het veld accepteert vier waarden, maar deze resulteren in slechts twee teamgroottes: "low" en "medium" gebruiken 4 agents, terwijl "high" en "xhigh" er 16 gebruiken.

Dit detail verdient zorgvuldige aandacht. De overstap van low naar medium, of van high naar xhigh, verandert het aantal agents niet: deze tussenliggende niveaus kunnen andere aspecten van het modelgedrag beïnvloeden, maar binnen elk paar blijft het team gelijk. Stel u een interface voor waarin u de gebruiker vier niveaus van onderzoeksdiepte biedt; zij zullen er slechts twee waarnemen, en uw twee extra knoppen zullen hun keuze alleen maar verwarren.

Chat Completions wordt niet ondersteund

Hier ligt de beperking waar de meeste ontwikkelaars bij hun eerste poging op vastlopen: Chat Completions wordt niet ondersteund voor multi-agent. U moet de Responses API gebruiken, dus client.responses.create, en niet client.chat.completions.create.

# WERKT NIET
response = client.chat.completions.create(
    model="grok-4.20-multi-agent-0309",
    messages=[{"role": "user", "content": "..."}],
)

Deze aanroep geeft een foutmelding. Als uw bestaande code volledig vertrouwt op Chat Completions – zoals veel bestaande codebases doen – is de wijziging niet slechts een swap van de modelnaam: u moet de aanroep migreren naar een ander invoer- en uitvoerformaat. Schat deze inspanning in voordat u de integratie toezegt.

Streaming met de OpenAI SDK

Streaming blijft beschikbaar, wederom via de Responses API:

stream = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "Summarize this week's tech announcements"}],
    stream=True,
)

for event in stream:
    if hasattr(event, 'delta') and event.delta:
        print(event.delta, end="", flush=True)

De test hasattr(event, 'delta') is het waard om ongewijzigd te laten: de event-stream van de Responses API bevat meer dan alleen tekst, en blindelings event.delta uitlezen bij elke event zou een uitzondering veroorzaken.

Voordelen en beperkingen van deze aanpak

Het grootste voordeel van deze route is tijdwinst: u installeert geen andere SDK, uw ontwikkelaars krijgen een vertrouwde syntaxis en het wisselen tussen xAI- en OpenAI-modellen in dezelfde codebase wordt triviaal. Voor een team dat de multi-agent-modus wil evalueren zonder zich vast te leggen op een volledig project, is dit de kortste weg.

De beperkingen hebben allemaal dezelfde oorzaak: u gaat via een compatibiliteitslaag, waardoor u verliest wat specifiek is voor xAI. U krijgt geen toegang tot agent_count (vervangen door indirecte controle via reasoning.effort), verbose_streaming of use_encrypted_content. Daarbovenop komt dat de toewijzing van inspanning naar agents afkomstig is van een beta-API en kan veranderen: als uw product specifiek afhankelijk is van het aantal gebruikte agents, blijft de native SDK de verstandige keuze.

Belangrijkste punten

  • De OpenAI SDK werkt met multi-agent via base_url="https://api.x.ai/v1"
  • U regelt het aantal agents via reasoning.effort (low/medium = 4, high/xhigh = 16)
  • Chat Completions wordt NIET ondersteund – gebruik uitsluitend de Responses API
  • Sommige parameters die exclusief zijn voor de xAI SDK (agent_count, verbose_streaming) zijn niet beschikbaar