หากต้องการใช้ Gemini API คุณต้องมีคีย์ API คุณสร้างคีย์ได้ด้วยการคลิกเพียงไม่กี่ครั้งใน Google AI Studio
รับคีย์ Gemini API ใน Google AI Studio
ตั้งค่าคีย์ API
สำหรับการทดสอบครั้งแรก คุณสามารถฝังคีย์ API ลงในโค้ดได้ แต่ควรเป็นแค่ชั่วคราวเนื่องจากไม่ปลอดภัย ส่วนที่เหลือของส่วนนี้จะอธิบายวิธีตั้งค่าคีย์ API ในพื้นที่เป็นตัวแปรสภาพแวดล้อมด้วยระบบปฏิบัติการต่างๆ
Linux/macOS - Bash
Bash เป็นการกําหนดค่าเทอร์มินัล Linux และ macOS ที่พบบ่อย คุณสามารถตรวจสอบว่าคุณมีไฟล์การกําหนดค่าสําหรับบริการดังกล่าวหรือไม่โดยเรียกใช้คําสั่งต่อไปนี้
~/.bashrc
หากคำตอบคือ "ไม่มีไฟล์หรือไดเรกทอรีดังกล่าว" คุณจะต้องสร้างไฟล์นี้และเปิดโดยเรียกใช้คำสั่งต่อไปนี้ หรือใช้ zsh
touch ~/.bashrc
open ~/.bashrc
ถัดไป คุณต้องตั้งค่าคีย์ API โดยเพิ่มคําสั่งส่งออกต่อไปนี้
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>
หลังจากบันทึกไฟล์แล้ว ให้ใช้การเปลี่ยนแปลงโดยเรียกใช้
source ~/.bashrc
macOS - Zsh
Zsh เป็นการกําหนดค่าเทอร์มินัล Linux และ macOS ทั่วไป คุณสามารถตรวจสอบว่าคุณมีไฟล์การกําหนดค่าสําหรับบริการดังกล่าวหรือไม่โดยเรียกใช้คําสั่งต่อไปนี้
~/.zshrc
หากคำตอบคือ "ไม่มีไฟล์หรือไดเรกทอรีดังกล่าว" คุณจะต้องสร้างไฟล์นี้และเปิดโดยเรียกใช้คำสั่งต่อไปนี้ หรือใช้ bash
touch ~/.zshrc
open ~/.zshrc
ถัดไป คุณต้องตั้งค่าคีย์ API โดยเพิ่มคําสั่งส่งออกต่อไปนี้
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>
หลังจากบันทึกไฟล์แล้ว ให้ใช้การเปลี่ยนแปลงโดยเรียกใช้คำสั่งต่อไปนี้
source ~/.zshrc
Windows
- ค้นหา "ตัวแปรสภาพแวดล้อม" ในการตั้งค่าระบบ
- แก้ไข "ตัวแปรของผู้ใช้" (สําหรับผู้ใช้ปัจจุบัน) หรือ "ตัวแปรของระบบ" (สําหรับผู้ใช้ทุกคน - ใช้ด้วยความระมัดระวัง)
- สร้างตัวแปรและเพิ่ม
export GEMINI_API_KEY=your_key_here
- ใช้การเปลี่ยนแปลง
ส่งคำขอ Gemini API รายการแรก
คุณสามารถใช้คําสั่ง curl เพื่อยืนยันการตั้งค่าได้ ดังนี้
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{
"parts":[{"text": "Write a story about a magic backpack."}]
}]
}'
รักษาคีย์ API ให้ปลอดภัย
การรักษาคีย์ Gemini API ให้ปลอดภัยเป็นเรื่องสำคัญ สิ่งที่ควรคำนึงถึงเมื่อใช้คีย์ Gemini API มีดังนี้
Google AI Gemini API ใช้คีย์ API สำหรับการให้สิทธิ์ หากผู้อื่นมีสิทธิ์เข้าถึงคีย์ Gemini API บุคคลเหล่านั้นจะเรียกใช้โควต้าของโปรเจ็กต์ได้ ซึ่งอาจส่งผลให้โควต้าหมดหรือมีการเรียกเก็บเงินเพิ่มเติมสำหรับโปรเจ็กต์ที่มีการเรียกเก็บเงิน นอกเหนือจากการเข้าถึงโมเดลและไฟล์ที่ปรับแต่งแล้ว
การเพิ่มข้อจำกัดของคีย์ API ช่วยจำกัดขอบเขตการใช้งานผ่านคีย์ API แต่ละคีย์ได้
คุณมีหน้าที่รับผิดชอบในการรักษาคีย์ Gemini API ให้ปลอดภัย
- อย่าตรวจสอบคีย์ Gemini API ในระบบควบคุมแหล่งที่มา
- แอปพลิเคชันฝั่งไคลเอ็นต์ (Android, Swift, เว็บ และ Dart/Flutter) มีความเสี่ยงที่จะเปิดเผยคีย์ API เราไม่แนะนำให้ใช้ SDK ไคลเอ็นต์ AI ของ Google ในแอปเวอร์ชันที่ใช้งานจริงเพื่อเรียกใช้ Google AI Gemini API จากแอปบนอุปกรณ์เคลื่อนที่และเว็บโดยตรง
คุณอ่านบทความสนับสนุนนี้เพื่อดูแนวทางปฏิบัติแนะนำทั่วไปบางส่วนได้ด้วย