Activer Code Execution dans l'API

Exécuter du code Python via l’API Grok

Code Execution permet au modèle d’écrire et d’exécuter du code Python en temps réel dans un environnement sandboxé sécurisé. Au lieu de simplement générer du code que vous devriez exécuter vous-même, le modèle exécute le code directement et vous retourne les résultats. C’est un outil puissant pour les calculs, l’analyse de données et la validation de code.

Identifiants selon les SDKs

L’identifiant de l’outil varie selon le SDK utilisé :

Cette différence de nommage est importante. Utilisez l’identifiant correspondant à votre SDK pour éviter les erreurs.

Activation basique

cURL / JSON direct

{
  "model": "grok-4.20-reasoning",
  "input": "Calcule la somme des 1000 premiers nombres premiers",
  "tools": [
    {"type": "code_interpreter"}
  ]
}

xAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Calcule la somme des 1000 premiers nombres premiers",
    tools=[client.tools.code_execution()]
)

print(response.output_text)

OpenAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Calcule la somme des 1000 premiers nombres premiers",
    tools=[{"type": "code_interpreter"}]
)

Vercel AI SDK (JavaScript)

const response = await generateText({
  model: xai("grok-4.20-reasoning"),
  prompt: "Calcule la somme des 1000 premiers nombres premiers",
  tools: [xai.tools.codeExecution()]
});

Comment le modèle utilise Code Execution

Quand Code Execution est activé, le processus est le suivant :

1. Le modèle analyse la requête et détermine qu’un calcul ou une analyse de données est nécessaire
2. Il écrit du code Python adapté au problème
3. Le code est exécuté dans le sandbox Python de xAI
4. Le modèle reçoit les résultats de l’exécution (sortie standard, erreurs éventuelles)
5. Il formule sa réponse en intégrant les résultats

Si le code produit une erreur, le modèle peut automatiquement corriger et réexécuter — ce qui peut générer plusieurs invocations pour une seule requête.

Recommandation de température

Pour les calculs mathématiques et l’analyse de données, xAI recommande d’utiliser des valeurs de température basses (0.0 à 0.3). Une température basse réduit la variabilité dans la génération de code et produit des résultats plus reproductibles.

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Calcule le ratio de Sharpe pour ce portefeuille...",
    tools=[client.tools.code_execution()],
    temperature=0.1
)

Points clés à retenir

• Code Execution permet l’exécution de Python en temps réel dans un sandbox sécurisé
• L’identifiant varie selon le SDK : code_execution (xAI), code_interpreter (OpenAI)
• Le modèle écrit, exécute et interprète le code automatiquement
• Utilisez grok-4.20-reasoning et une température basse pour les calculs
• Le coût est de 0,005 $ par exécution, avec des invocations multiples possibles