代码执行

<ph type="x-smartling-placeholder"></ph>

Gemini API 代码执行功能让模型能够 Python 代码,并根据结果迭代学习,直到得出 最终输出。您可以使用此代码执行功能来构建应用 可受益于基于代码的推理过程,并可生成文本输出。对于 例如,您可以在求解方程或解题的应用中使用代码执行 处理文本。

AI Studio 和 Gemini API 中都支持代码执行功能。在 AI Studio 中 您可以在高级设置下启用代码执行功能。Gemini API 提供代码执行工具,类似于 函数调用。添加后 代码执行,模型就会决定何时使用该工具。

开始执行代码

本部分假定您已安装 Gemini SDK 并配置了一个 API 键,如快速入门中所示。

代码执行与函数调用

代码执行和函数调用 类似功能:

  • 通过代码执行,模型可以在固定的隔离环境内运行 API 后端中的代码, 环境
  • 利用函数调用,您可以运行模型请求的函数, 任何环境

一般来说,如果代码执行可以处理您的使用,您应该优先使用 这种情况。代码执行更易于使用(您只需启用它即可),并在 单个 GenerateContent 请求(因此会产生一次费用)。函数 调用会接收一个额外的 GenerateContent 请求以发回输出 从每次函数调用中获取费用(因此会产生多次费用)。

在大多数情况下,如果您有自己的函数,则应使用函数调用 如果您希望在本地运行,则应使用代码执行功能, API 为您编写和运行 Python 代码并返回结果。

结算

通过 Gemini API。系统会按当前的输入和输出费率向您收费 tokens

关于代码执行费用结算,您还需要注意以下几点:

  • 您只需为传递到模型的输入令牌支付一次费用, 您需要为模型返回的最终输出令牌付费。
  • 表示所生成代码的令牌计为输出令牌。
  • 代码执行结果也会计为输出词元。

限制

  • 模型只能生成和执行代码。它无法返回其他制品 例如媒体文件
  • 该功能不支持文件 I/O 或涉及非文本输出的用例 (例如,数据图或 CSV 文件上传)。
  • 在超时之前,代码执行最长可运行 30 秒。
  • 在某些情况下,启用代码执行可能会导致其他方面的性能下降 模型输出(例如写故事)。
  • 不同模型使用代码的能力存在一些差异 成功执行。Gemini 1.5 Pro 表现最佳 构建机器学习模型。