Code-uitvoering inschakelen in de API
Op deze pagina
Python-code uitvoeren via de Grok API
Met Code Execution kan het model Python-code schrijven en in realtime uitvoeren binnen een beveiligde, geïsoleerde omgeving (sandbox). In plaats van alleen code te genereren die u zelf moet uitvoeren, voert het model de code direct uit en retourneert het de resultaten. Dit is een krachtige tool voor berekeningen, data-analyse en codevalidatie.
Tool-identificatoren per SDK
De tool-identificator verschilt afhankelijk van de SDK die u gebruikt:
| SDK | Identificator |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Dit naamverschil is belangrijk. Gebruik de identificator die bij uw SDK past om fouten te voorkomen.
Basisactivatie
cURL / Directe JSON
{
"model": "grok-4.20-0309-reasoning",
"input": "Calculate the sum of the first 1,000 prime numbers",
"tools": [
{"type": "code_interpreter"}
]
}
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Calculate the sum of the first 1,000 prime numbers",
tools=[client.tools.code_execution()]
)
print(response.output_text)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Calculate the sum of the first 1,000 prime numbers",
tools=[{"type": "code_interpreter"}]
)
Vercel AI SDK (JavaScript)
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "Calculate the sum of the first 1,000 prime numbers",
tools: [xai.tools.codeExecution()]
});
Hoe het model Code Execution gebruikt
Wanneer Code Execution is ingeschakeld, verloopt het proces als volgt:
- Het model analyseert het verzoek en stelt vast dat een berekening of data-analyse nodig is
- Het schrijft Python-code die op het probleem is afgestemd
- De code wordt uitgevoerd in de Python-sandbox van xAI
- Het model ontvangt de uitvoeringsresultaten (standaarduitvoer, eventuele fouten)
- Het formuleert zijn antwoord op basis van deze resultaten
Als de code een fout produceert, kan het model deze automatisch corrigeren en opnieuw uitvoeren. Dit kan leiden tot meerdere aanroepen voor één enkel verzoek.
Aanbeveling voor temperatuur
Voor wiskundige berekeningen en data-analyse raadt xAI aan lage temperatuurwaarden te gebruiken (0,0 tot 0,3). Een lage temperatuur vermindert de variabiliteit bij het genereren van code en levert reproduceerbaardere resultaten op.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Calculate the Sharpe ratio for this portfolio...",
tools=[client.tools.code_execution()],
temperature=0.1
)
Belangrijkste punten
- Code Execution maakt realtime Python-uitvoering mogelijk in een beveiligde sandbox
- De identificator verschilt per SDK:
code_execution(xAI),code_interpreter(OpenAI) - Het model schrijft, voert uit en interpreteert de code automatisch
- Gebruik
grok-4.20-0309-reasoningen een lage temperatuur voor berekeningen - De kosten bedragen $0,005 per uitvoering, waarbij meerdere aanroepen mogelijk zijn