結論先說
- 開啟只需在
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 條評論
還沒有評論,來搶沙發~