结论先说
- 开启只需在
tools里加一项code_execution:模型会根据提示词自行判断是否写 Python 代码,放进 Google 托管隔离沙箱运行后再把结果整合成最终回答。 - 单次运行限时
30 秒,报错最多自动改码重跑5 次:沙箱断网且不能运行pip install,但已预装numpy、pandas、matplotlib、sympy等常用科学计算库。 - 返回内容拆成三段结构:在响应的
parts里依次能拿到模型生成的代码(executable_code)、沙箱标准输出(code_execution_result)以及最终文字总结。 - 工具本身不收额外调用费:完全按所用模型的输入与输出 token 单价计费,生成的代码和沙箱返回结果都会计入 token 用量。
- 谷歌账号准备与多工具订阅入口:使用 Gemini、Google AI Studio 与 Antigravity 需具备符合地区与年龄要求的个人谷歌账号,缺号可查看本站 谷歌账号购买说明(含带 2FA 的 谷歌邮箱成品号),跨平台付费订阅总览见 AI 会员充值中心。

图:本站根据 Gemini API 官方文档:Code execution 整理的示意图
本文根据 Google AI for Developers 官方文档《Code execution》《Gemini Developer API pricing》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Google 官方网站。
适用于谁
- 用 Gemini API 做财务核算、数学推导、字符串计数或 CSV 表格统计,不希望模型心算出错的开发者;
- 搜「gemini api code execution 怎么开」,想知道
google-genaiSDK 具体参数和返回字段怎么取的人; - 想提前摸清沙箱超时上限、预装 Python 库范围以及开启后怎么算钱的人。
一、在 Python SDK 里怎么开启与读取结果
还没安装新版官方 SDK 或没拿到密钥的读者,可以先看 Gemini API Key 获取教程 与 Gemini API Python 快速入门。在 google-genai SDK 中,单轮调用和多轮对话(Chat)都能直接挂载代码执行工具:
python
from google import genai
from google.genai import types
client = genai.Client() # 自动读取环境变量 GEMINI_API_KEY
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="计算前 50 个质数的和,并验证结果是否为偶数。",
config=types.GenerateContentConfig(
tools=[types.Tool(code_execution=types.ToolCodeExecution())]
),
)
for part in response.candidates[0].content.parts:
if part.text is not None:
print("【说明】", part.text)
if part.executable_code is not None:
print("【生成代码】\n", part.executable_code.code)
if part.code_execution_result is not None:
print("【运行状态】", part.code_execution_result.outcome)
print("【运行输出】\n", part.code_execution_result.output)
如果你只想拿最终结论展示给前端用户,直接读 response.text 即可;如果想在界面上像笔记本那样折叠展示「模型写了什么代码、跑出了什么日志」,就遍历 parts 分别提取 executable_code 和 code_execution_result。在 Google AI Studio 网页里调试时,也可以直接在右侧「运行设置(Run settings)」面板打开「代码执行(Code execution)」开关,详见 Google AI Studio 系统指令与工具设置。
二、传入 CSV 文件分析与画图写法
代码执行工具适合搭配结构化文本或 CSV 表格使用。把本地小文件或通过 Files API 上传的文件和工具一起传给模型,沙箱里的 Python 环境就能直接用 pandas 读取并计算:
python
uploaded_csv = client.files.upload(file="sales_2026.csv")
response = client.models.generate_content(
model="gemini-2.5-flash",
contents=[
uploaded_csv,
"用 pandas 按月份汇总销售额、计算环比增长率,并用 matplotlib 画出折线图。",
],
config=types.GenerateContentConfig(
tools=[types.Tool(code_execution=types.ToolCodeExecution())]
),
)
for idx, part in enumerate(response.candidates[0].content.parts):
if part.inline_data is not None and part.inline_data.mime_type.startswith("image/"):
with open(f"chart_{idx}.png", "wb") as f:
f.write(part.inline_data.data)
需要注意官方文档对文件输入输出的两条边界说明:
- 输入文件类型:纯文本和 CSV、TSV 效果最稳,沙箱脚本能直接按文件路径打开;图片或复杂排版 PDF 属于模型多模态视觉读取,不是给 Python 脚本直接解析成表格用的。
- 输出产物限制:沙箱不支持导出任意二进制文件(如
.zip、音频视频);用matplotlib画图时,支持的模型会把渲染好的 PNG 图表装在inline_data里返回,但部分接口页仍写「仅返回代码和文本输出」,上线前请以你锁定的具体模型版本验证为准。
三、沙箱硬限制与 token 计费拆解

图:本站根据 Gemini API 官方文档:Code execution 整理的示意图
把代码执行接入生产环境前,建议对照下表核查边界与账单算法:
| 维度 | 官方规则说明 | 开发注意事项 |
|---|---|---|
| 单次运行上限 | 最长 30 秒 | 超时会被强制终止,大体积循环或全表笛卡尔积要先在提示词里限制规模 |
| 自动纠错重跑 | 单次请求最多执行 5 次 | 第一次代码报错时模型会读报错栈自己改代码重跑,同时消耗更多 token |
| 网络与装包 | 完全断网,禁止 pip install | 只能调用 numpy、pandas、scipy、matplotlib、sympy 等预装库 |
| 工具计费方式 | 无附加功能费,按 输入 + 输出 token 计费 | 模型写出的代码算输出 token;代码重跑时的中间结果重新喂给模型也会计入输入 token |
各模型每百万 token 的单价及免费层额度上限,可对照 Gemini API 官方价格说明 与 Gemini API 免费额度与速率限制。如果你还没有可用于开通 Google AI Studio 或绑定结算项目的合规账号,可以查看本站 谷歌账号购买说明 或前往 充值与账号服务总览。
常见问题
问:开了 code_execution 后,模型为什么有时候还是直接口头回答、没写代码?
答:官方说明是否调用工具由模型自行决定。如果你希望某类计算题每次都强制跑代码核验,可以在系统指令或提示词末尾明确加上「请编写并运行 Python 代码计算,不要直接估算」。
问:代码执行能和自定义函数调用(Function Calling)同时开吗?
答:取决于具体模型与 API 版本。较早的接口不允许在同一次请求里混开内置工具与自定义函数,而新版多工具支持列表以官方文档各模型的能力矩阵为准;混用报 400 INVALID_ARGUMENT 时,拆成两步调用最稳妥。
问:沙箱里上次请求生成的变量,下一轮请求还在吗?
答:单次请求内部可以有状态迭代,但不同请求之间不能把沙箱当持久服务器用。在多轮对话(chats)里,你需要保留完整历史消息传回,模型才能看到上一轮生成的代码和输出。
问:没有可用的个人谷歌账号,或者同时想开其他主流 AI 会员怎么办?
答:本站提供即买即发的 谷歌邮箱成品号(登录方法见 谷歌账号购买页),同时支持支付宝、微信支付与 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服务,实时价格与质保细则以各商品页说明为准。
相关教程
- Gemini API Python 调用教程:安装 google-genai SDK、流式输出与多轮对话
- Google AI Studio 系统指令怎么写:运行设置与内置工具开关
- Gemini API 价格:各模型每百万 tokens 多少钱、免费层和付费层差异
- Gemini API 报错 400、403、429、500 排查对照表
参考资料
- Gemini API 官方文档:Code execution — https://ai.google.dev/gemini-api/docs/code-execution
- Gemini Developer API pricing — https://ai.google.dev/gemini-api/docs/pricing
0 条评论
还没有评论,来抢沙发~