Fitur eksekusi kode Gemini API memungkinkan model membuat dan menjalankan kode Python serta belajar secara iteratif dari hasilnya hingga 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. 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 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
Bagian ini mengasumsikan bahwa Anda telah menginstal Gemini SDK dan mengonfigurasi kunci API, seperti yang ditunjukkan dalam panduan memulai.
Eksekusi kode versus panggilan fungsi
Eksekusi kode dan panggilan fungsi adalah fitur yang serupa:
- Eksekusi kode memungkinkan model menjalankan kode di backend API dalam lingkungan tetap dan terisolasi.
- Dengan panggilan fungsi, Anda dapat menjalankan fungsi yang diminta model, di lingkungan apa pun yang Anda inginkan.
Secara umum, sebaiknya gunakan eksekusi kode jika dapat menangani kasus
penggunaan Anda. Eksekusi kode lebih mudah digunakan (Anda cukup mengaktifkannya) dan diselesaikan dalam
satu permintaan GenerateContent (sehingga menimbulkan satu tagihan). Panggilan fungsi memerlukan permintaan GenerateContent tambahan untuk mengirim kembali output dari setiap panggilan fungsi (sehingga menimbulkan beberapa tagihan).
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 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 file 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 adalah model dengan performa terbaik, berdasarkan pengujian kami.