การเรียกใช้โค้ด

ฟีเจอร์การเรียกใช้โค้ดของ Gemini API ช่วยให้โมเดลสร้างและเรียกใช้โค้ด Python ได้ และเรียนรู้ผลลัพธ์ซ้ำๆ จนกว่าผลลัพธ์จะออกมาเป็นผลลัพธ์สุดท้าย คุณสามารถใช้ความสามารถในการดำเนินการกับโค้ดนี้เพื่อสร้างแอปพลิเคชันที่ใช้ประโยชน์จากการให้เหตุผลตามโค้ดและที่สร้างเอาต์พุตข้อความได้ เช่น คุณสามารถใช้การเรียกใช้โค้ดในแอปพลิเคชันที่แก้สมการหรือข้อความประมวลผล

การเรียกใช้โค้ดพร้อมให้ใช้งานทั้งใน AI Studio และ Gemini API ใน AI Studio คุณจะเปิดใช้การเรียกใช้โค้ดได้ในแผงด้านขวาใต้เครื่องมือ Gemini API มีการเรียกใช้โค้ดในฐานะเครื่องมือ ซึ่งคล้ายกับการเรียกใช้ฟังก์ชัน หลังจากที่เพิ่มการเรียกใช้โค้ดเป็นเครื่องมือ โมเดลจะตัดสินใจว่าควรใช้เมื่อใด

สภาพแวดล้อมการดำเนินการโค้ดประกอบด้วยไลบรารีต่อไปนี้: altair, chess, cv2, matplotlib, mpmath, numpy, pandas, pdfminer, reportlab, seaborn, sklearn, statsmodels, striprtf, sympy และ tabulate คุณไม่สามารถติดตั้งไลบรารีของคุณเอง

ก่อนเริ่มต้น

ก่อนเรียกใช้ Gemini API โปรดตรวจสอบว่าคุณได้ติดตั้ง SDK ที่ต้องการ รวมถึงกําหนดค่าคีย์ Gemini API ให้พร้อมใช้งานแล้ว

เริ่มต้นใช้งานการเรียกใช้โค้ด

อินพุต/เอาต์พุต (I/O)

เริ่มต้นด้วย Gemini 2.0 Flash การเรียกใช้โค้ดจะรองรับอินพุตไฟล์และเอาต์พุตกราฟ เมื่อใช้ความสามารถอินพุตและเอาต์พุตใหม่เหล่านี้ คุณสามารถอัปโหลดไฟล์ CSV และข้อความ ถามคำถามเกี่ยวกับไฟล์ และสร้างกราฟ Matplotlib เป็นส่วนหนึ่งของการตอบกลับ

ราคา I/O

เมื่อใช้ I/O การเรียกใช้โค้ด ระบบจะเรียกเก็บเงินสำหรับโทเค็นอินพุตและโทเค็นเอาต์พุต ดังนี้

ป้อนโทเค็น:

  • ข้อความแจ้งผู้ใช้

โทเค็นเอาต์พุต:

  • โค้ดที่โมเดลสร้างขึ้น
  • เอาต์พุตของการเรียกใช้โค้ดในสภาพแวดล้อมโค้ด
  • ข้อมูลสรุปที่โมเดลสร้างขึ้น

รายละเอียด I/O

เมื่อทำงานกับ I/O ของการเรียกใช้โค้ด โปรดทราบถึงรายละเอียดทางเทคนิคต่อไปนี้

  • รันไทม์สูงสุดของสภาพแวดล้อมโค้ดคือ 30 วินาที
  • หากสภาพแวดล้อมโค้ดทำให้เกิดข้อผิดพลาด โมเดลอาจตัดสินใจสร้างเอาต์พุตของโค้ดใหม่ ซึ่งสามารถเกิดขึ้นได้สูงสุด 5 ครั้ง
  • ขนาดสูงสุดของไฟล์อินพุตจะถูกจำกัดโดยหน้าต่างโทเค็นโมเดล ใน AI Studio โดยใช้ Gemini Flash 2.0 ขนาดไฟล์อินพุตสูงสุดคือ 1 ล้านโทเค็น (ประมาณ 2 MB สำหรับไฟล์ข้อความของประเภทอินพุตที่รองรับ) หากคุณอัปโหลดไฟล์ที่มีขนาดใหญ่เกินไป AI Studio จะไม่อนุญาตให้คุณส่งไฟล์
เลี้ยวเดียว แบบ 2 ทิศทาง (Multimodal Live API)
รุ่นที่รองรับ Gemini 2.0 ทุกรุ่น เฉพาะรุ่นทดลองของ Flash
ประเภทอินพุตไฟล์ที่รองรับ .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts
รองรับการพล็อตไลบรารี Matplotlib Matplotlib
การใช้เครื่องมือหลายอย่าง ไม่ ใช่

การเรียกเก็บเงิน

โดยไม่มีค่าใช้จ่ายเพิ่มเติมสำหรับการเปิดใช้การรันโค้ดจาก Gemini API ระบบจะเรียกเก็บเงินจากคุณในอัตราโทเค็นอินพุตและเอาต์พุตปัจจุบันโดยอิงตามโมเดล Gemini ที่คุณใช้อยู่

สิ่งอื่นที่ควรทราบเกี่ยวกับการเรียกเก็บเงินสำหรับการเรียกใช้โค้ดมีดังนี้

  • ระบบจะเรียกเก็บเงินเพียงครั้งเดียวสำหรับโทเค็นอินพุตที่คุณส่งไปยังโมเดล และจะมีการเรียกเก็บเงินสำหรับโทเค็นเอาต์พุตสุดท้ายที่โมเดลส่งกลับมา
  • โทเค็นที่แสดงถึงโค้ดที่สร้างขึ้นจะนับเป็นโทเค็นเอาต์พุต โค้ดที่สร้างขึ้นอาจมีข้อความและเอาต์พุตหลายรูปแบบ เช่น รูปภาพ
  • ผลลัพธ์ของการเรียกใช้โค้ดจะนับเป็นโทเค็นเอาต์พุตด้วย

รูปแบบการเรียกเก็บเงินจะแสดงในแผนภาพต่อไปนี้

โมเดลการเรียกเก็บเงินของการเรียกใช้โค้ด

  • ระบบจะเรียกเก็บเงินจากคุณที่อัตราโทเค็นอินพุตและเอาต์พุตปัจจุบันโดยอิงตามโมเดล Gemini ที่คุณใช้อยู่
  • หาก Gemini ใช้การเรียกใช้โค้ดเมื่อสร้างคำตอบ พรอมต์เดิม โค้ดที่สร้างขึ้น และผลลัพธ์ของโค้ดที่เรียกใช้จะมีป้ายกำกับเป็นโทเค็นกลางและมีการเรียกเก็บเงินเป็นโทเค็นอินพุต
  • จากนั้น Gemini จะสร้างสรุปและแสดงผลโค้ดที่สร้างขึ้น ผลลัพธ์ของโค้ดที่เรียกใช้ และสรุปขั้นสุดท้าย ซึ่งระบบจะเรียกเก็บเงินเป็นโทเค็นเอาต์พุต
  • Gemini API จะรวมจำนวนโทเค็นระดับกลางในการตอบกลับจาก API เพื่อให้คุณทราบว่าเหตุใดคุณจึงได้รับโทเค็นอินพุตเพิ่มเติมนอกเหนือจากข้อความแจ้งครั้งแรก

ข้อจำกัด

  • โมเดลนี้สามารถสร้างและเรียกใช้โค้ดได้เท่านั้น และไม่สามารถแสดงผลอาร์ติแฟกต์อื่นๆ เช่น ไฟล์สื่อ
  • ในบางกรณี การเปิดใช้การเรียกใช้โค้ดอาจทำให้เกิดการถดถอยในส่วนอื่นๆ ของเอาต์พุตโมเดล (เช่น การเขียนเรื่องราว)
  • โมเดลต่างๆ สามารถใช้การเรียกใช้โค้ดได้สำเร็จแตกต่างกันไป