Eksekusi kode

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 panel kanan pada bagian Alat. Gemini API menyediakan eksekusi kode sebagai alat, mirip dengan panggilan fungsi. Setelah Anda menambahkan eksekusi kode sebagai alat, model akan menentukan kapan harus menggunakannya.

Lingkungan eksekusi kode mencakup library berikut: altair, chess, cv2, matplotlib, mpmath, numpy, pandas, pdfminer, reportlab, seaborn, sklearn, statsmodels, striprtf, sympy, dan tabulate. Anda tidak dapat menginstal library Anda sendiri.

Mulai menggunakan eksekusi kode

Bagian ini mengasumsikan bahwa Anda telah menyelesaikan langkah-langkah penyiapan dan konfigurasi yang ditampilkan di panduan memulai.

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 dihasilkan oleh model
  • Output eksekusi kode di lingkungan kode
  • Ringkasan yang dihasilkan oleh model

Detail I/O

Saat Anda menggunakan 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 periode token model. Di AI Studio, 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 belokan 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
Library plot yang didukung Matplotlib Matplotlib
Penggunaan beberapa 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 sekali untuk token input yang Anda teruskan 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 eksekusi kode

  • Anda ditagih dengan tarif token input dan output saat ini berdasarkan model Gemini yang Anda gunakan.
  • Jika Gemini menggunakan eksekusi kode saat membuat respons, perintah asli, kode yang dihasilkan, dan hasil kode yang dieksekusi diberi label token perantara dan ditagih sebagai token input.
  • Gemini kemudian membuat ringkasan dan menampilkan kode yang dihasilkan, hasil kode yang dieksekusi, dan ringkasan akhir. Hal ini ditagih 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 ini hanya dapat membuat dan menjalankan 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 untuk menggunakan eksekusi kode dengan sukses.