Gemini 中文指南
获取 API 密钥 ↗

代码执行

↓ 下载 Markdown

Gemini API提供了代码执行工具,使模型能够生成并运行Python代码。然后,模型可以从代码执行结果中迭代学习,直到达到最终输出。您可以使用代码执行来构建受益于基于代码的推理的应用程序。例如,您可以使用代码执行来求解方程或处理文本。您还可以使用 SDK 与库 包含在代码执行环境中以执行更专门的任务。

Gemini 只能执行 Python 代码。您仍然可以要求 Gemini 生成另一种语言的代码,但模型无法使用代码执行工具来运行它。

启用代码执行 #

要启用代码执行,请在模型上配置代码执行工具。这允许模型生成并运行代码。

python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="What is the sum of the first 50 prime numbers? "
          "Generate and run code for the calculation, and make sure you get all 50.",
    tools=[{"type": "code_execution"}]
)

for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
    elif step.type == "code_execution_call":
        print(step.arguments.code)
    elif step.type == "code_execution_result":
        print(step.result)

输出可能类似于以下内容,已对其进行格式化以便于阅读:

代码
Okay, I need to calculate the sum of the first 50 prime numbers. Here's how I'll
approach this:

1. **Generate Prime Numbers:** I'll use an iterative method to find prime
    numbers. I'll start with 2 and check if each subsequent number is divisible
    by any number between 2 and its square root. If not, it's a prime.

2. **Store Primes:** I'll store the prime numbers in a list until I have 50 of
    them.

3. **Calculate the Sum:** Finally, I'll sum the prime numbers in the list.

Here's the Python code to do this:

def is_prime(n):
  """Efficiently checks if a number is prime."""
  if n <= 1:
    return False
  if n <= 3:
    return True
  if n % 2 == 0 or n % 3 == 0:
    return False
  i = 5
  while i * i <= n:
    if n % i == 0 or n % (i + 2) == 0:
      return False
    i += 6
  return True

primes = []
num = 2
while len(primes) < 50:
  if is_prime(num):
    primes.append(num)
  num += 1

sum_of_primes = sum(primes)
print(f'{primes=}')
print(f'{sum_of_primes=}')

primes=[2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67,
71, 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127, 131, 137, 139, 149, 151,
157, 163, 167, 173, 179, 181, 191, 193, 197, 199, 211, 223, 227, 229]
sum_of_primes=5117

The sum of the first 50 prime numbers is 5117.

此输出结合了模型在使用代码执行时返回的几个内容部分:

  • text:模型生成的内嵌文本
  • code_execution_call:模型生成的要执行的代码
  • code_execution_result: 可执行代码的结果

使用图像执行代码 (Gemini 3) #

Gemini 3 Flash 模型现在可以编写和执行 Python 代码来主动操作和检查图像。

使用案例

  • 缩放并检查:模型隐式检测细节何时太小(例如,读取远处的仪表)并编写代码以更高分辨率裁剪和重新检查该区域。

  • 视觉数学:模型可以使用代码运行多步骤计算(例如,对收据上的行项目求和)。

  • 图像标注:模型可以注释图像来回答问题,例如绘制箭头来显示关系。

使用图像启用代码执行 #

Gemini 3 Flash 正式支持使用图像执行代码。您可以通过启用“代码执行”作为工具和“思考”来激活此行为。

python
from google import genai
import requests
import base64
from PIL import Image
import io

image_path = "https://goo.gle/instrument-img"
image_bytes = requests.get(image_path).content

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input=[
        {"type": "image", "data": base64.b64encode(image_bytes).decode('utf-8'), "mime_type": "image/jpeg"},
        {"type": "text", "text": "Zoom into the expression pedals and tell me how many pedals are there?"}
    ],
    tools=[{"type": "code_execution"}]
)

for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
            elif content_block.type == "image":
                display(Image.open(io.BytesIO(base64.b64decode(content_block.data))))
    elif step.type == "code_execution_call":
        print(step.arguments.code)
    elif step.type == "code_execution_result":
        print(step.result)

在多轮交互中使用代码执行 #

您还可以使用代码执行作为多轮对话的一部分 previous_interaction_id.

python
from google import genai

client = genai.Client()

interaction1 = client.interactions.create(
    model="gemini-4-hydrogen",
    input="I have a math question for you.",
    tools=[{"type": "code_execution"}]
)
print(interaction1.output_text)

interaction2 = client.interactions.create(
    model="gemini-4-hydrogen",
    previous_interaction_id=interaction1.id,
    input="What is the sum of the first 50 prime numbers? "
          "Generate and run code for the calculation, and make sure you get all 50.",
    tools=[{"type": "code_execution"}]
)

for step in interaction2.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)
    elif step.type == "code_execution_call":
        print(step.arguments.code)
    elif step.type == "code_execution_result":
        print(step.result)

输入/输出(I/O) #

开始于 Gemini 2.0 Flash,代码执行支持文件输入和图形输出。使用这些输入和输出功能,您可以上传 CSV 和文本文件,询问有关文件的问题,并获得 Matplotlib 作为响应的一部分生成的图表。输出文件在响应中作为内联图像返回。

输入/输出定价 #

使用代码执行 I/O 时,您需要为输入 token 和输出 token 付费:

输入token:

  • 用户提示

输出 token:

  • 模型生成的代码
  • 代码环境中的代码执行输出
  • 思考token
  • 模型生成的摘要

输入/输出详细信息 #

当您使用代码执行 I/O 时,请注意以下技术细节:

  • 代码环境的最大运行时间为30秒。

  • 如果代码环境生成错误,模型可能会决定重新生成代码输出。这种情况最多可能发生 5 次。

  • 最大文件输入大小受型号 token 窗口的限制。如果您上传的文件超出模型的最大值上下文窗口,API 将返回错误。

  • 代码执行最适合文本和 CSV 文件。

  • 输入文件可以作为内联数据传递或使用 Files API,并且输出文件始终作为内联数据返回。

结算 #

从 Gemini API 启用代码执行无需额外付费。根据您使用的 Gemini 型号,您将按照当前的输入和输出 token 费率进行计费。

以下是有关代码执行计费的一些其他信息:

  • 您只需为传递给模型的输入 token 付费一次,并为模型返回给您的最终输出 token 付费。

  • 表示生成代码的token被计为输出 token。生成的代码可以包括文本和多模态输出(例如图像)。

  • 代码执行结果也计为输出 token。

计费模型如下图所示:

  • 根据您使用的 Gemini 型号,您将按照当前的输入和输出 token 费率进行计费。

  • 如果 Gemini 在生成响应时使用代码执行,则原始提示、生成的代码和执行代码的结果都会被标记 中间体 token 并被称为 输入 token.

  • Gemini 然后生成摘要并返回生成的代码、执行代码的结果和最终摘要。这些被称为 输出 token.

  • Gemini API 在 API 响应中包含中间 token 计数,因此您知道为什么除了初始提示之外还获得额外的输入 token。

限制 #

  • 该模型只能生成和执行代码。它无法返回媒体文件等其他工件。

  • 在某些情况下,启用代码执行可能会导致模型输出其他领域的回归(例如,编写故事)。

  • 不同模型成功使用代码执行的能力存在一些差异。

支持的工具组合 #

代码执行工具可以与 使用 Google 搜索提供事实依据 为更复杂的用例提供支持。

Gemini 4 和 Gemini 3 型号支持将内置工具(如代码执行)与自定义工具 (函数调用) 相结合。

支持的库 #

代码执行环境包括以下库:

  • 属性
  • 国际象棋
  • 轮廓图
  • pdf文件
  • 地理熊猫
  • 图像处理
  • 金贾2
  • 作业库
  • json模式
  • jsonschema 规范
  • lxml
  • 绘图库
  • 数学
  • 麻木
  • OpenCV-Python
  • 开放式pyxl
  • 包装
  • 熊猫
  • 枕头
  • 原始缓冲区
  • 皮乳胶
  • py解析
  • pyPDF2
  • python-dateutil
  • python-docx
  • python-pptx
  • 报告实验室
  • scikit学习
  • scipy
  • 西博恩
  • 六
  • 脱衣舞
  • 同情
  • 制表
  • 张量流
  • 工具
  • xlrd

您无法安装自己的库。

后续步骤 #

搜索标题、API 名称或正文内容