工具名称:code_execution / code_interpreter
费用:$5 / 1K 次调用
代码执行工具让模型能够在安全的沙盒环境中编写和运行 Python 代码。 这对于需要精确计算、数据处理或复杂逻辑的任务特别有用 — 模型不需要"心算",而是通过执行实际代码获得准确结果。
基本用法
Python (OpenAI)
from openai import OpenAI
client = OpenAI(api_key=os.getenv("XAI_API_KEY"), base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="计算斐波那契数列前 100 项的和",
tools=[{"type": "code_execution"}],
)
print(response.output_text)注意:在 gRPC API(Python xAI SDK)中,code_interpreter 不受支持。 请使用 Responses API 或 code_execution 工具名称。
适用场景
- 数学计算 — 复杂数学公式、统计分析、数值计算
- 数据处理 — 数据清洗、转换、聚合
- 算法验证 — 运行算法代码验证结果
- 文件处理 — 处理上传的 CSV、JSON 等文件
- 可视化 — 生成图表和可视化(结果以图像返回)
沙盒环境
代码在隔离的沙盒环境中执行,具有以下特性:
- Python 运行时环境
- 预装常用科学计算库(如 NumPy、Pandas 等)
- 无网络访问 — 代码无法访问外部网络
- 执行时间和资源有限制
- 每次调用独立 — 不保留之前执行的状态