รับคีย์ API

หากต้องการใช้ Gemini API คุณต้องมีคีย์ API คุณสร้างคีย์ได้ด้วยคลิกเดียวใน Google AI Studio

รับคีย์ API

ยืนยันคีย์ API ด้วยคำสั่ง curl

คุณใช้คำสั่ง curl เพื่อยืนยันการตั้งค่าได้ คุณส่งคีย์ API ใน URL ได้โดยทำดังนี้

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

หรือในส่วนหัว x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

รักษาคีย์ API ให้ปลอดภัย

คุณควรเก็บรักษาคีย์ Gemini API ให้ปลอดภัย สิ่งที่ควรคำนึงถึงเมื่อใช้คีย์ Gemini API

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

  • เมื่อคลิกรับคีย์ API ใน Google AI Studio คุณเลือกได้ว่าจะจัดสรรคีย์ Gemini API ในโปรเจ็กต์ Google Cloud ใหม่หรือที่มีอยู่ รายการคีย์ API ใน Google AI Studio จะแสดงคีย์ API ทั้งหมดที่ AI Studio จัดสรรไว้ให้ใช้งานกับ Google AI Gemini API (พร้อมกับโปรเจ็กต์ Google Cloud ที่เกี่ยวข้องทั้งหมด)

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

  • การเพิ่มข้อจำกัดของคีย์ API จะช่วยจำกัดพื้นที่ผิวที่ใช้ได้ผ่านคีย์ API แต่ละรายการ โดยค่าเริ่มต้น คีย์ Gemini API ที่ Google AI Studio สร้างขึ้นจะใช้ได้กับ Google AI Gemini API เท่านั้น (ชื่ออย่างเป็นทางการว่า "Generative Language API" หรือ generativelanguage.googleapis.com)

    • หากมีคีย์ API ภายในโปรเจ็กต์ Google Cloud ที่ไม่มีข้อจํากัดของ API หรือคีย์ API ที่ได้เพิ่ม Generative Language API ไว้ในรายการที่อนุญาตแล้ว คุณจะใช้คีย์เหล่านั้นกับ Google AI Gemini API ได้ แนวทางปฏิบัติแนะนำคือการจำกัดคีย์ API แต่ละรายการให้มีเฉพาะ API ที่คุณเรียกใช้โดยใช้คีย์นั้นเท่านั้น
    • โปรดทราบว่าแม้จะมีข้อจำกัดเกี่ยวกับคีย์ API หากผู้ไม่ประสงค์ดีได้รับคีย์ API ของคุณ ผู้ไม่ประสงค์ดีก็อาจใช้คีย์นี้ทำการเรียกโดยใช้โควต้าของโปรเจ็กต์สำหรับ API ทั้งหมดที่อยู่ในรายการที่อนุญาตสำหรับคีย์ API นั้นได้

  • คุณมีหน้าที่รักษาคีย์ Gemini API ให้ปลอดภัย

    • อย่าตรวจสอบคีย์ Gemini API ในการควบคุมแหล่งที่มา
    • แอปพลิเคชันฝั่งไคลเอ็นต์ (Android, Swift, เว็บ และ Dart/Flutter) มีความเสี่ยงที่จะเปิดเผยคีย์ API เราจึงไม่แนะนำให้ใช้ SDK ไคลเอ็นต์ AI ของ Google ในแอปเวอร์ชันที่ใช้งานจริงเพื่อเรียกใช้ Google AI Gemini API โดยตรงจากแอปบนอุปกรณ์เคลื่อนที่และเว็บแอป ดูการเริ่มต้นใช้งาน SDK อย่างรวดเร็วเพื่อเรียนรู้แนวทางปฏิบัติแนะนำสำหรับแต่ละภาษาในการรักษาความปลอดภัยของคีย์ API

สำหรับแนวทางปฏิบัติแนะนำทั่วไป คุณยังอ่านบทความสนับสนุนนี้ได้อีกด้วย

ขั้นตอนถัดไป