Gemini API 代码执行(Code Execution)工具怎么开:让模型自动写并跑 Python 算题画表的参数与限制

想让 Gemini API 算数学题、统计 CSV 数据时不靠猜,而是自己写 Python 跑出准确结果?本文按官方文档整理 Code Execution 工具开启参数、返回结构解析、30 秒沙箱限制与 token 计费规则。

NNathaniel bigo··原创首发·AI 辅助撰写
9 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 其他 账号

结论先说

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

Gemini API 代码执行工作流程

图:本站根据 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-genai SDK 具体参数和返回字段怎么取的人;
  • 想提前摸清沙箱超时上限、预装 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 官方文档:Code execution — https://ai.google.dev/gemini-api/docs/code-execution
  • Gemini Developer API pricing — https://ai.google.dev/gemini-api/docs/pricing

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 单独备份导出 NotebookLM 笔记本与 Gemini 记录:只勾选指定服务不下载整个云端硬盘的步骤

    想把 NotebookLM 里的几十个研究笔记本、来源副本与音频概览,连同 Gemini 聊天记录一起备份到本地,又怕 Google Takeout 把整个云端硬盘和相册全打包?本文讲清先取消全选、精准勾选两项服务、解压目录查看与跨号迁移的做法。

    Gemini0
  2. 02

    Google Workspace 企业/教育版管理员怎么在后台给成员开启 Gemini 应用、NotebookLM 与设置年龄访问权限

    团队成员或学校师生登录 Google Workspace 账号时提示无权使用 Gemini 或打不开 NotebookLM?本文按 Google 管理控制台官方文档整理服务开关路径、组织部门(OU)与群组放行、18 岁年龄访问权限设置及对话保留合规配置。

    Gemini0
  3. 03

    安卓手机默认助手换成 Gemini 后设闹钟、发短信或控制智能家居失灵怎么办:Workspace 与实用程序扩展开启步骤

    安卓手机把默认语音助手从 Google Assistant 换成 Gemini 后,喊它定闹钟、开手电筒、发短信或开关智能灯全都没反应?本文按官方帮助中心整理实用程序(Utilities)、Google Home 与 Workspace 关联应用开启步骤及锁屏放行设置。

    Gemini0
  4. 04

    Gemini 写长代码或长文档到一半突然停住、格式截断怎么无缝续写:锚点接续指令与 Canvas 分块修改技巧

    让 Gemini 写几百行代码或万字长文时经常写到一半突然停住、Markdown 代码块没闭合,直接回「继续」又重头抄一遍?本文整理字面锚点续写指令、代码块防乱码补齐法与 Canvas 局部圈选修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音频播客(Audio Overview)高阶玩法:用自定义引导词控制对谈深度、受众水平与重点章节(附模板)

    NotebookLM 生成的中文音频播客总是泛泛而谈、漏掉核心章节或夹杂生僻英文缩写?本文按官方帮助中心整理来源勾选过滤、四种播客格式搭配与三维自定义引导词写法,附 4 套可直接复制的中文控场模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 视频、网页或扫描版 PDF 提示「无法导入来源」怎么办:无字幕、反爬与纯图 PDF 逐项解决

    往 NotebookLM(Gemini Notebook)塞 YouTube 链接、外文网页或扫描教材时总是亮红叹号提示无法导入来源?本文按官方帮助中心逐项排查无字幕视频、反爬动态页与加密纯图 PDF 的替代导入步骤。

    Gemini0

同产品的其他教程

  1. 01

    iPhone 操作按钮(Action Button)或锁屏小组件一键开启 ChatGPT / Gemini 实时语音对话配置教程

    每次在 iPhone 上练口语或语音提问都要解锁、找图标、再点耳机按钮太繁琐?本文整理利用 iPhone 操作按钮(Action Button)、iOS 18 锁屏底部控制项、控制中心与背面轻点一键直达 ChatGPT 实时语音或 Gemini Live 的完整步骤。

    ChatGPTGemini0
  2. 02

    Firebase Studio(原 Project IDX)是什么、怎么用:浏览器云端全栈开发环境搭配 Gemini 智能体实战

    以前收藏的 Project IDX 网址为什么跳到了 Firebase Studio?本文按 Google 官方文档讲清它的全栈云端定位、App Prototyping 原型智能体、Code 视图切换、.idx/dev.nix 环境定制与免费工作区上限。

    Gemini其他 AI 工具0
  3. 03

    Google Colab 内置 Gemini 编程助手怎么用:免费云端 GPU 笔记本自动生成数据分析代码、修报错与限额说明

    不用配本地 Python 环境,怎么在 Google Colab 云端笔记本里免费用 Gemini 自动写数据分析代码、一键修复红字报错并跑 Data Science Agent?本文整理四大入口用法、Secrets 密钥管理与免费版限额。

    Gemini其他 AI 工具0
  4. 04

    Gemini API Token 计数(count_tokens)与多模态计费规则:图片分辨率、音频秒数与视频帧率怎么折算 Token

    传一张高清截图或一段 10 分钟视频给 Gemini API 到底扣多少 Token?本文按官方文档拆解 258 图片切片、每秒 32 音频与每秒 263 视频折算公式,附 count_tokens 免费预估与降本代码。

    Gemini0
  5. 05

    Gemini API 回答被安全策略拦截(SAFETY / PROHIBITED_CONTENT)怎么办:阈值调节边界与合规提示词排查

    调用 Gemini API 翻译文档或分析安全日志时返回空白、报 finish_reason: SAFETY 或 PROHIBITED_CONTENT 怎么办?本文详解四类可调安全阈值代码写法、不可关闭的硬性红线区别与误报排查步骤。

    Gemini0
  6. 06

    Gemini API 图像生成与多轮改图怎么调:用 google-genai SDK 出图、局部修改与宽高比控制参数

    怎么用 Python 代码调用 Gemini API 生成高清配图并像聊天一样连续局部改图?本文详解 google-genai SDK 原生生图代码、多轮对话改图、参考图融合与 aspect_ratio 宽高比配置。

    Gemini0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~