Fitur eksekusi kode Gemini API memungkinkan model membuat dan menjalankan kode Python serta belajar secara iteratif dari hasilnya hingga mencapai output akhir. Anda dapat menggunakan kemampuan eksekusi kode ini untuk mem-build aplikasi yang mendapatkan manfaat dari penalaran berbasis kode dan 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 Setelan lanjutan. Gemini API menyediakan eksekusi kode sebagai alat, mirip dengan panggilan fungsi. Setelah Anda menambahkan eksekusi kode sebagai alat, model akan menentukan kapan harus menggunakannya.
Mulai menggunakan eksekusi kode
Bagian ini mengasumsikan bahwa Anda telah menyelesaikan langkah-langkah penyiapan dan konfigurasi yang ditampilkan di 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.
- Panggilan fungsi memungkinkan Anda 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 hanya 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 sekali untuk token input yang Anda teruskan ke model, dan 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 ini hanya dapat membuat dan menjalankan 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 selama maksimal 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 untuk menggunakan eksekusi kode dengan sukses. Gemini 1.5 Pro adalah model dengan performa terbaik, berdasarkan pengujian kami.