Fitur eksekusi kode Gemini API memungkinkan model membuat dan menjalankan kode Python, serta belajar secara iteratif dari hasil hingga mencapai output akhir. Anda dapat menggunakan kemampuan eksekusi kode ini untuk membangun aplikasi yang mendapatkan manfaat dari penalaran berbasis kode dan yang menghasilkan output teks. Misalnya, Anda dapat menggunakan eksekusi kode dalam 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 Advanced settings. Gemini API menyediakan eksekusi kode sebagai alat, mirip dengan panggilan fungsi. Setelah Anda menambahkan eksekusi kode sebagai alat, model akan 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 kunci API, seperti yang ditunjukkan dalam quickstart.
Eksekusi kode versus panggilan fungsi
Eksekusi kode dan panggilan fungsi memiliki fitur serupa:
- Eksekusi kode memungkinkan model menjalankan kode di backend API di lingkungan tetap dan terisolasi.
- Dengan panggilan fungsi, Anda dapat menjalankan fungsi yang diminta model, di lingkungan apa pun yang Anda inginkan.
Secara umum, Anda harus memilih menggunakan eksekusi kode jika dapat menangani kasus
penggunaan Anda. Eksekusi kode lebih mudah digunakan (Anda cukup mengaktifkannya) dan di-resolve dalam
satu permintaan GenerateContent (sehingga menimbulkan satu tagihan). Panggilan fungsi memerlukan permintaan GenerateContent tambahan untuk mengirimkan kembali output dari setiap panggilan fungsi (sehingga menimbulkan beberapa biaya).
Untuk sebagian besar kasus, Anda harus menggunakan panggilan fungsi jika memiliki fungsi sendiri yang ingin dijalankan secara lokal, dan Anda harus menggunakan eksekusi kode jika ingin API menulis dan menjalankan kode Python untuk Anda dan menampilkan hasilnya.
Penagihan
Tidak ada biaya tambahan untuk mengaktifkan eksekusi kode dari Gemini API. Anda akan ditagih dengan tarif token input dan output saat ini.
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 ditampilkan kepada Anda 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 file media.
- Fitur ini tidak mendukung I/O file atau kasus penggunaan yang melibatkan output non-teks (misalnya, plot data).
- Eksekusi kode dapat berjalan maksimal selama 30 detik sebelum waktu habis.
- Dalam beberapa kasus, mengaktifkan eksekusi kode dapat menyebabkan regresi di area output model lainnya (misalnya, menulis cerita).
- Ada beberapa variasi dalam kemampuan berbagai model agar berhasil menggunakan eksekusi kode. Gemini 1.5 Pro adalah model dengan performa terbaik, berdasarkan pengujian kami.