Ir al contenido principal
Español— Elegir un idioma
Menú

Activar la ejecución de código en la API

Lección 12 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Ejecutar código Python mediante la API de Grok
  2. Identificadores de herramienta por SDK
  3. Activación básica
  4. Cómo utiliza el modelo la ejecución de código
  5. Recomendación de temperatura
  6. Puntos clave

Ejecutar código Python mediante la API de Grok

La ejecución de código permite al modelo escribir y ejecutar código Python en tiempo real dentro de un entorno seguro y aislado (sandbox). En lugar de limitarse a generar código para que tú lo ejecutes, el modelo lo ejecuta directamente y devuelve los resultados. Es una herramienta potente para cálculos, análisis de datos y validación de código.

🐍
Python en sandbox
NumPy
Pandas, SciPy...
🔒
Aislado y seguro
5 $
/ 1.000 llamadas

Identificadores de herramienta por SDK

El identificador de la herramienta varía según el SDK que utilices:

SDKIdentificador
xAI SDKcode_execution
OpenAI Responses APIcode_interpreter
Vercel AI SDKxai.tools.codeExecution()

Esta diferencia de nomenclatura es importante. Utiliza el identificador que corresponda a tu SDK para evitar errores.

Activación básica

cURL / JSON directo

{
  "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()]
});

Cómo utiliza el modelo la ejecución de código

Cuando la ejecución de código está activada, el proceso funciona de la siguiente manera:

  1. El modelo analiza la solicitud y determina que es necesario realizar un cálculo o un análisis de datos.
  2. Escribe código Python adecuado para el problema.
  3. El código se ejecuta en el sandbox de Python de xAI.
  4. El modelo recibe los resultados de la ejecución (salida estándar, posibles errores).
  5. Formula su respuesta incorporando dichos resultados.

Si el código genera un error, el modelo puede corregirlo automáticamente y volver a ejecutarlo, lo que puede dar lugar a múltiples invocaciones para una única solicitud.

Recomendación de temperatura

Para cálculos matemáticos y análisis de datos, xAI recomienda utilizar valores de temperatura bajos (de 0,0 a 0,3). Una temperatura baja reduce la variabilidad en la generación de código y produce resultados más reproducibles.

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
)

Puntos clave

  • La ejecución de código permite la ejecución de Python en tiempo real en un sandbox seguro.
  • El identificador varía según el SDK: code_execution (xAI), code_interpreter (OpenAI).
  • El modelo escribe, ejecuta e interpreta el código automáticamente.
  • Utiliza grok-4.20-0309-reasoning y una temperatura baja para cálculos.
  • El coste es de 0,005 $ por ejecución, con la posibilidad de múltiples invocaciones.