สร้างเว็บด้วย Gemini API อย่างไรไม่ให้ API Key หลุดไปถึงผู้ใช้

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

คีย์อยู่ในตู้เซิร์ฟเวอร์ที่แยกจากหน้าต่างเบราว์เซอร์ สื่อถึงการเก็บความลับไว้หลังบ้าน

API Key ไม่ควรอยู่ในโค้ดที่เบราว์เซอร์ดาวน์โหลด

หลักการคือเก็บคีย์ไว้ฝั่งเซิร์ฟเวอร์ ไม่ใช่ฝั่งเบราว์เซอร์ แม้จะใช้ตัวแปรชื่อ SECRET_KEY หรือซ่อนปุ่มในหน้าเว็บ หากค่าถูกใส่ลงใน JavaScript ที่ส่งไปยังผู้ใช้ ก็มีโอกาสถูกอ่านได้ เอกสาร Google เรื่องการจัดการ Gemini API Key ระบุชัดว่าไม่ควรฝังคีย์ในเว็บหรือแอปมือถือที่เผยแพร่จริง และไม่ควร commit ลง Git

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

วิธีเรียก Gemini โดยเก็บ API Key ไว้บนเซิร์ฟเวอร์

ตัวอย่างเชิงแนวคิดของแอปถามตอบหนึ่งหน้า:

  1. ผู้ใช้พิมพ์คำถามในหน้าเว็บ จากนั้นเว็บส่งคำขอไปยัง API ของแอปเรา
  2. เซิร์ฟเวอร์ตรวจสิทธิ์ผู้ใช้ ขนาดข้อความ จำนวนคำขอ และขอบเขตงานที่อนุญาต
  3. เซิร์ฟเวอร์อ่านคีย์จาก environment variable หรือระบบจัดเก็บความลับ แล้วเรียก Gemini API
  4. เซิร์ฟเวอร์ตรวจและจำกัดข้อมูลที่จะส่งกลับ ก่อนตอบหน้าเว็บ

ในลำดับนี้เบราว์เซอร์ไม่ต้องรู้ค่า Gemini API Key เลย และเซิร์ฟเวอร์สามารถบันทึกยอดใช้งานแบบไม่เก็บข้อความส่วนตัวเกินจำเป็นได้ นี่เป็น แบบสถาปัตยกรรมแนะนำ ไม่ใช่การรับรองว่าระบบปลอดภัยอัตโนมัติ

สำหรับเว็บแบบ static การตั้งคีย์เป็น environment variable ตอน build ยังไม่พอ หากเครื่องมือ build แทนค่าลงในโค้ดฝั่งผู้ใช้ คีย์ก็ยังถูกส่งออกไปด้วย ต้องตรวจผล build และจุดที่เรียก API ว่าทำงานฝั่งใดจริง การย่อโค้ดหรือเปลี่ยนชื่อตัวแปรช่วยปิดบังได้เพียงผิวเผิน

เช็กก่อนเปิดให้คนอื่นใช้งาน

เอกสาร Google ที่ตรวจวันที่ 29 ตุลาคม 2569 แยก standard keys ที่ผูกการใช้กับโครงการ ออกจาก authorization keys ที่ผูกกับ service account และระบุว่าคีย์ใหม่ใน AI Studio เป็น authorization key ตั้งแต่ 28 พฤษภาคม 2026 อีกทั้งไม่รับ standard key ที่ไม่ได้ตั้งข้อจำกัด นักพัฒนาจึงต้องตรวจชนิดคีย์และข้อจำกัดของโครงการจริง Authorization key ยังเป็นความลับ ไม่ใช่สิทธิ์ให้นำไปฝังในเบราว์เซอร์ และไม่ทดแทนการตรวจสิทธิ์ผู้ใช้ของแอป

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

หากคีย์รั่ว ให้เปลี่ยนคีย์และตรวจการใช้งาน

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

หากคีย์รั่วในงานจริง ควรให้ผู้ดูแลระบบที่มีสิทธิ์ดำเนินการตามขั้นตอนขององค์กร และทบทวนว่าข้อมูลอื่นถูกเปิดเผยร่วมด้วยหรือไม่

สิ่งที่ API Key ไม่ได้ป้องกัน

การเก็บคีย์หลังบ้านช่วยลดการเปิดเผยความลับ แต่ไม่ได้แก้ปัญหา prompt injection, การโจมตี endpoint, ข้อมูลผิดพลาดจาก AI หรือค่าใช้จ่ายที่เพิ่มจากผู้ใช้จริงเอง การจำกัดคีย์ของผู้ให้บริการไม่ทดแทนการตรวจสิทธิ์และการกำหนดเพดานคำขอของแอป

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

อ่านต่อสร้างแอปด้วย Google AI Studio แล้ว ใครจ่ายเมื่อมีคนใช้งาน?อ่านต่อเรื่องผู้รับภาระค่า API และวิธีประมาณต้นทุนเมื่อเปิดให้คนใช้จริง

แหล่งอ้างอิง

ตรวจเอกสาร Google ณ 29 ตุลาคม 2569 (ตรวจข้อกำหนดชนิดคีย์และการจำกัด standard key อีกครั้ง) เป็นบทความอธิบายสถาปัตยกรรมจากเอกสาร ไม่ได้ตรวจระบบ production หรือสร้าง API key จริง ความสามารถและข้อกำหนดคีย์อาจเปลี่ยนได้