跳转到主要内容
千问云 home page
开放平台文档
工具调用

代码解释器

在沙箱中运行 Python 代码

代码解释器允许模型在对话过程中，于安全沙箱内编写并执行 Python 代码。当模型遇到需要计算的任务（如数学运算、数据分析或图表生成）时，会自动生成代码、执行并将结果整合到回复中。

快速开始

以下示例展示了完整的代码解释器请求及输出。
  • Responses API
  • Chat Completions
  • DashScope
import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
)

response = client.responses.create(
  model="qwen3-max-2026-01-23",
  input="12 的 3 次方是多少？",
  tools=[{"type": "code_interpreter"}],
  extra_body={"enable_thinking": True}
)

print(response.output_text)
print(response.usage)
响应示例
12 的 3 次方等于 **1728**。

计算过程：
12^3 = 12 x 12 x 12 = 144 x 12 = 1728

工作原理

启用后，模型按以下阶段处理每个请求：
1

思考

模型分析请求，确定解题方法。
2

代码执行

模型在沙箱中生成并执行 Python 代码。
3

结果处理

模型处理执行结果，确定后续步骤。
4

生成回复

模型生成自然语言回复。
步骤 2 和 3 在单次请求中可能重复执行多次。

支持的模型

系列模型说明
Qwen-Maxqwen3-max, qwen3-max-2026-01-23需要启用思考模式
Qwen-Plusqwen3.6-plus, qwen3.6-plus-2026-04-02, qwen3.5-plus, qwen3.5-plus-2026-02-15
Qwen-Flashqwen3.5-flash, qwen3.5-flash-2026-02-23
开源模型qwen3.5-397b-a17b, qwen3.5-122b-a10b, qwen3.5-27b, qwen3.5-35b-a3b

获取执行的代码

DashScope API 在每个流式数据块的 tool_info 字段中返回解释器执行的代码。每个条目包含代码字符串和值为 code_interpreter 的 type 字段： 
"tool_info": [
  {
    "code_interpreter": {"code": "123**21"},
    "type": "code_interpreter"
  }
]
当模型在单次请求中多次调用解释器时，tool_info 会累积所有调用记录。总调用次数可通过 usage.plugins 获取： 
"plugins": {"code_interpreter": {"count": 2}}
Chat Completions API 不返回执行的代码。如需查看生成的代码，请使用 Responses API 或 DashScope API。

使用限制

  • 必须使用流式输出（Chat Completions 和 DashScope）：代码解释器仅支持流式模式（stream: true），非流式请求会返回错误。Responses API 无此限制。
  • 代码解释器与 function calling 互斥，不能同时启用。
    同时启用两者会报错。
  • 启用代码解释器后，单次请求会触发多次模型推理。usage 字段汇总了所有推理的 Token 消耗。

计费

代码解释器暂时免费，但会增加 Token 消耗。