Récupérer le raisonnement chiffré avec include

Accéder au raisonnement interne des modèles grok-4

Les modèles grok-4 produisent un raisonnement interne que vous ne pouvez pas lire en clair. Cependant, xAI vous permet de récupérer ce raisonnement sous forme chiffrée grâce au paramètre include. Ce mécanisme ouvre la porte à des utilisations avancées, notamment la réutilisation du raisonnement dans les requêtes suivantes.

Le paramètre include

Pour récupérer le contenu chiffré du raisonnement, ajoutez "reasoning.encrypted_content" dans le tableau include de votre requête à l’API Responses :

from openai import OpenAI

client = OpenAI(
    api_key="votre-cle-api",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Analysez la complexité algorithmique du tri fusion.",
    include=["reasoning.encrypted_content"]
)

Structure de la réponse

La réponse contient le raisonnement chiffré dans un format spécifique. Ce contenu est un blob encodé que vous pouvez stocker mais pas interpréter. Sa structure interne est opaque par conception.

# Parcourir les éléments de la réponse
for item in response.output:
    if item.type == "reasoning":
        # Contenu chiffré du raisonnement
        encrypted = item.encrypted_content
        print(f"Taille du raisonnement chiffré : {len(encrypted)} caractères")
    elif item.type == "message":
        # Réponse finale du modèle
        print(f"Réponse : {item.content[0].text}")

Sans include : pas de raisonnement dans la réponse

Si vous n’incluez pas "reasoning.encrypted_content" dans le paramètre include, la réponse ne contiendra que le résultat final. Le raisonnement aura lieu côté serveur, mais aucune trace ne sera retournée :

# Sans include - seule la réponse finale est retournée
response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Analysez la complexité algorithmique du tri fusion."
)
# response.output ne contient que le message, pas de reasoning

Les tokens de raisonnement sont tout de même comptabilisés et facturés, même sans include. La différence est que vous ne recevez pas le contenu chiffré pour une éventuelle réutilisation.

Quand utiliser include

Récupérer le raisonnement chiffré a un coût : la réponse est plus volumineuse et la bande passante augmente. Utilisez include dans ces cas :

• Conversations multi-tours : vous prévoyez de poursuivre la conversation et voulez réinjecter le contexte de raisonnement
• Cache de pensée : vous stockez le raisonnement pour des requêtes similaires futures
• Audit : vous conservez une trace complète de la réponse pour des raisons de conformité
• Débogage : vous travaillez avec le support xAI et devez fournir le raisonnement complet

Stockage du raisonnement chiffré

Le contenu chiffré peut être stocké comme n’importe quelle chaîne de caractères. En base de données, un champ TEXT ou JSONB suffit :

import json

# Extraire et stocker le raisonnement chiffré
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Sauvegarder avec la réponse
record = {
    "question": "Analysez la complexité du tri fusion.",
    "response": response.output[-1].content[0].text,
    "encrypted_reasoning": reasoning_data,
    "model": "grok-4.20-reasoning",
    "timestamp": "2026-04-03T10:00:00Z"
}

Points clés à retenir

• Le paramètre include=["reasoning.encrypted_content"] récupère le raisonnement chiffré des modèles grok-4
• Sans include, le raisonnement a lieu mais n’est pas retourné (les tokens sont quand même facturés)
• Le contenu chiffré est un blob opaque que vous ne pouvez pas lire en clair
• Ce contenu peut être stocké et réutilisé dans les requêtes suivantes (leçon suivante)
• N’utilisez include que si vous avez un usage concret du raisonnement chiffré