程式碼執行

Gemini API 程式碼執行功能可讓模型產生及執行 Python 程式碼,並從結果中逐步學習,直到產生最終輸出內容為止。您可以使用這項程式碼執行功能,建構可從程式碼推理中受益,並產生文字輸出的應用程式。舉例來說,您可以在解決方程式或處理文字的應用程式中使用程式碼執行功能。

AI Studio 和 Gemini API 都支援程式碼執行作業。在 AI Studio 中,您可以在「進階設定」下方啟用程式碼執行功能。Gemini API 提供程式碼執行工具,類似於函式呼叫。將程式碼執行作業新增為工具後,模型會決定何時使用該工具。

開始執行程式碼

本節假設您已完成快速入門導覽課程中的設定和設定步驟。

程式碼執行與函式呼叫

程式碼執行和函式呼叫功能類似:

  • 程式碼執行作業可讓模型在固定的隔離環境中執行 API 後端程式碼。
  • 函式呼叫可讓您在所需環境中執行模型要求的函式。

一般來說,如果程式碼執行作業可以處理您的用途,建議您使用這項作業。程式碼執行作業的使用方式更簡單 (只要啟用即可),且會在單一 GenerateContent 要求中解析 (因此只會產生單一費用)。函式呼叫需要額外的 GenerateContent 要求,才能從每個函式呼叫傳回輸出內容 (因此會產生多次費用)。

在大多數情況下,如果您有要在本機執行的函式,應使用函式呼叫;如果您希望 API 為您編寫及執行 Python 程式碼並傳回結果,則應使用程式碼執行功能。

帳單

啟用 Gemini API 的程式碼執行作業不會產生額外費用。我們會以輸入和輸出符記的目前費率向您收費。

以下是關於程式碼執行作業的其他計費注意事項:

  • 系統只會針對您傳遞至模型的輸入符記收費一次,並針對模型傳回的最終輸出符記收費。
  • 代表產生程式碼的符記會計為輸出符記。
  • 程式碼執行結果也會計入輸出符號。

限制

  • 模型只能產生及執行程式碼。因此無法傳回媒體檔案等其他構件
  • 這項功能不支援檔案 I/O,或是涉及非文字輸出的用途 (例如資料圖表或上傳 CSV 檔案)。
  • 程式碼在逾時前最多可執行 30 秒。
  • 在某些情況下,啟用程式碼執行功能可能會導致模型輸出的其他區域發生迴歸問題 (例如撰寫故事)。
  • 不同模型使用程式碼執行功能的能力有所差異。測試結果顯示 Gemini 1.5 Pro 是成效最佳的模型