Fitur eksekusi kode Gemini API memungkinkan model untuk membuat dan menjalankan kode Python dan belajar secara iteratif dari hasil sampai ia mencapai output akhir. Anda bisa menggunakan kemampuan eksekusi kode ini untuk membangun aplikasi yang mendapat manfaat dari penalaran berbasis kode dan yang menghasilkan {i>output<i} teks. Sebagai misalnya, Anda dapat menggunakan eksekusi kode di aplikasi yang menyelesaikan persamaan atau memproses teks.
Eksekusi kode tersedia di AI Studio dan Gemini API. Di AI Studio, Anda dapat mengaktifkan eksekusi kode di bagian Setelan lanjutan. Gemini API menyediakan eksekusi kode sebagai alat, mirip dengan panggilan fungsi. Setelah Anda menambahkan eksekusi kode sebagai alat, model memutuskan kapan akan menggunakannya.
Memulai eksekusi kode
 Lihat di ai.google.dev
|
 Berjalan di Google Colab
|
 Lihat sumber di GitHub
|
Bagian ini mengasumsikan bahwa Anda telah menginstal Gemini SDK dan mengonfigurasi API seperti yang ditunjukkan dalam panduan memulai.
Eksekusi kode versus panggilan fungsi
Eksekusi kode dan panggilan fungsi fitur serupa:
- Eksekusi kode memungkinkan model menjalankan kode di backend API secara tetap dan terisolasi lingkungan fleksibel App Engine.
- Dengan panggilan fungsi, Anda dapat menjalankan fungsi yang diminta model, di lingkungan apa pun yang Anda inginkan.
Secara umum, Anda harus lebih memilih menggunakan eksekusi kode jika ia dapat menangani penggunaan Anda
ini masalahnya atau bukan. Eksekusi kode lebih mudah digunakan (Anda cukup mengaktifkannya) dan diselesaikan dalam
satu permintaan GenerateContent (sehingga menimbulkan satu tagihan). Fungsi
panggilan memerlukan permintaan GenerateContent tambahan untuk mengirimkan kembali output
dari setiap panggilan fungsi (sehingga menimbulkan lebih dari satu biaya).
Untuk sebagian besar kasus, Anda harus menggunakan panggilan fungsi jika Anda memiliki fungsi sendiri yang ingin dijalankan secara lokal, dan Anda harus menggunakan eksekusi kode jika ingin API guna menulis dan menjalankan kode Python untuk Anda, lalu menampilkan hasilnya.
Penagihan
Tidak ada biaya tambahan untuk mengaktifkan eksekusi kode dari Gemini API. Anda akan ditagih dengan tarif input dan output saat ini token lebih lanjut.
Berikut adalah beberapa hal lain yang perlu diketahui tentang penagihan untuk eksekusi kode:
- Anda hanya ditagih satu kali untuk token input yang diteruskan ke model, dan Anda ditagih untuk token output akhir yang dikembalikan oleh model.
- Token yang mewakili kode yang dihasilkan dihitung sebagai token output.
- Hasil eksekusi kode juga dihitung sebagai token output.
Batasan
- Model hanya dapat membuat dan mengeksekusi kode. Metode ini tidak dapat menampilkan artefak lain seperti {i>file<i} media.
- Fitur ini tidak mendukung I/O file atau kasus penggunaan yang melibatkan output non-teks (misalnya, plot data atau upload file CSV).
- Eksekusi kode dapat berjalan maksimal selama 30 detik sebelum waktu habis.
- Dalam beberapa kasus, mengaktifkan eksekusi kode dapat menyebabkan regresi di area lain output model (misalnya, menulis cerita).
- Ada beberapa variasi dalam kemampuan berbagai model dalam menggunakan kode berhasil dieksekusi. Gemini 1.5 Pro memiliki performa terbaik berdasarkan pengujian kita.