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 panel kanan pada bagian Tools. Gemini API menyediakan eksekusi kode sebagai alat, mirip dengan panggilan fungsi. Setelah Anda menambahkan eksekusi kode sebagai alat, model akan memutuskan kapan akan menggunakannya.
Lingkungan eksekusi kode mencakup pustaka berikut:altair Bahasa Indonesia:chess Bahasa Indonesia:cv2 Bahasa Indonesia:matplotlib Bahasa Indonesia:mpmath Bahasa Indonesia:numpy Bahasa Indonesia:pandas Bahasa Indonesia:pdfminer Bahasa Indonesia:reportlab Bahasa Indonesia:seaborn Bahasa Indonesia:sklearn Bahasa Indonesia:statsmodels Bahasa Indonesia:striprtf Bahasa Indonesia:sympy , Dantabulate. Anda tidak dapat menginstal library Anda sendiri.
Sebelum memulai
Sebelum memanggil Gemini API, pastikan Anda telah menginstal SDK pilihan, dan kunci Gemini API telah dikonfigurasi dan siap digunakan.
Mulai menggunakan eksekusi kode
Input/output (I/O)
Mulai dari Gemini 2.0 Flash, eksekusi kode mendukung input file dan output grafik. Dengan menggunakan kemampuan input dan output baru ini, Anda dapat mengupload file CSV dan teks, mengajukan pertanyaan tentang file, dan membuat grafik Matplotlib sebagai bagian dari respons.
Harga I/O
Saat menggunakan I/O eksekusi kode, Anda akan dikenai biaya untuk token input dan token output:
Token input:
- Perintah pengguna
Token output:
- Kode yang dibuat oleh model
- Output eksekusi kode di lingkungan kode
- Ringkasan yang dibuat oleh model
Detail I/O
Saat Anda bekerja dengan I/O eksekusi kode, perhatikan detail teknis berikut:
- Runtime maksimum lingkungan kode adalah 30 detik.
- Jika lingkungan kode menghasilkan error, model dapat memutuskan untuk membuat ulang output kode. Hal ini dapat terjadi hingga 5 kali.
- Ukuran input file maksimum dibatasi oleh jendela token model. Di AI Studio, dengan menggunakan Gemini Flash 2.0, ukuran file input maksimum adalah 1 juta token (sekitar 2 MB untuk file teks dari jenis input yang didukung). Jika Anda mengupload file yang terlalu besar, AI Studio tidak akan mengizinkan Anda mengirimkannya.
| Satu putaran | Dua Arah (Multimodal Live API) | |
|---|---|---|
| Model yang didukung | Semua model Gemini 2.0 | Hanya model eksperimental Flash |
| Jenis input file yang didukung | .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts | .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts |
| Merencanakan library yang didukung | Matplotlib | Matplotlib |
| Penggunaan multi-alat | Tidak | Ya |
Penagihan
Tidak ada biaya tambahan untuk mengaktifkan eksekusi kode dari Gemini API. Anda akan ditagih dengan tarif token input dan output saat ini berdasarkan model Gemini yang Anda gunakan.
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 ditampilkan kepada Anda oleh model.
- Token yang mewakili kode yang dihasilkan dihitung sebagai token output. Kode yang dihasilkan dapat mencakup teks dan output multimodal seperti gambar.
- Hasil eksekusi kode juga dihitung sebagai token output.
Model penagihan ditampilkan dalam diagram berikut:
- Anda akan ditagih dengan tarif token input dan output saat ini berdasarkan model Gemini yang Anda gunakan.
- Jika Gemini menggunakan eksekusi kode saat membuat respons Anda, perintah asli, kode yang dihasilkan, dan hasil kode yang dieksekusi akan diberi label token menengah dan ditagih sebagai token input.
- Gemini kemudian membuat ringkasan dan menampilkan kode yang dihasilkan, hasil dari kode yang dieksekusi, dan ringkasan akhir. Keduanya disebut sebagai token output.
- Gemini API menyertakan jumlah token perantara dalam respons API, sehingga Anda tahu alasan Anda mendapatkan token input tambahan di luar perintah awal.
Batasan
- Model hanya dapat membuat dan mengeksekusi kode. Metode ini tidak dapat menampilkan artefak lain seperti file media.
- Dalam beberapa kasus, mengaktifkan eksekusi kode dapat menyebabkan regresi di area lain output model (misalnya, menulis cerita).
- Ada beberapa variasi dalam kemampuan berbagai model agar berhasil menggunakan eksekusi kode.