การใช้คีย์ Gemini API

หากต้องการใช้ Gemini API คุณต้องตรวจสอบสิทธิ์คำขอ คุณสามารถตรวจสอบสิทธิ์โดยใช้คีย์ API มาตรฐานหรือคีย์ API การให้สิทธิ์

สร้างหรือดูคีย์ Gemini API

ประเภทคีย์ API: มาตรฐานเทียบกับการให้สิทธิ์

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

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

Gemini API จะเปลี่ยนจากคีย์มาตรฐานเป็นคีย์การตรวจสอบสิทธิ์เพื่อให้มั่นใจว่ามีการใช้งานอย่างปลอดภัย ดังนี้

  • ค่าเริ่มต้นของคีย์การตรวจสอบสิทธิ์: ตั้งแต่วันที่ 28 พฤษภาคม 2026 เป็นต้นไป คีย์ API ใหม่ทั้งหมดที่สร้างใน Google AI Studio จะสร้างเป็นคีย์การตรวจสอบสิทธิ์โดยอัตโนมัติ
  • คีย์ที่ไม่มีการจำกัดถูกปฏิเสธ: Gemini API จะปฏิเสธคำขอจากคีย์มาตรฐานที่ไม่มีการจำกัด คีย์ API มาตรฐานที่มีข้อจำกัดที่ชัดเจนจะยังคงใช้งานได้ต่อไป ข้อจำกัดนี้จะป้องกันการใช้คีย์โดยไม่ได้รับอนุญาตซึ่งอาจมีการแชร์แบบสาธารณะหรือลิงก์กับบริการอื่นๆ

การจัดการคีย์ API ใน Google AI Studio

คุณจัดการโปรเจ็กต์และคีย์ได้โดยตรงใน Google AI Studio

โปรเจ็กต์ Google Cloud

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

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

กำลังนำเข้าโปรเจ็กต์

โดยค่าเริ่มต้น Google AI Studio จะไม่แสดงโปรเจ็กต์ Google Cloud ทั้งหมดของคุณ คุณต้องนําเข้าโปรเจ็กต์ที่ต้องการใช้ ดังนี้

  1. ไปที่ Google AI Studio
  2. เปิดแดชบอร์ดจากแผงด้านซ้าย แล้วเลือกโปรเจ็กต์
  3. คลิกปุ่มนำเข้าโปรเจ็กต์
  4. ค้นหาและเลือกโปรเจ็กต์ Google Cloud ที่ต้องการนําเข้า แล้วคลิกนําเข้า
  5. เมื่อนำเข้าแล้ว ให้ไปที่หน้าคีย์ API ในแดชบอร์ดเพื่อสร้างคีย์ในโปรเจ็กต์นั้น

การแก้ปัญหาเกี่ยวกับสิทธิ์ในการสร้างคีย์

หากปุ่มสร้างคีย์ API ไม่พร้อมใช้งานและแสดงข้อความ "คุณไม่มีสิทธิ์สร้างคีย์ในโปรเจ็กต์นี้" แสดงว่าคุณไม่มีสิทธิ์ IAM ที่จำเป็น

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

  • resourcemanager.projects.get: อนุญาตให้ AI Studio ยืนยันโปรเจ็กต์
  • apikeys.keys.create: อนุญาตให้สร้างคีย์
  • serviceusage.services.enable: ตรวจสอบว่าได้เปิดใช้ Generative Language API แล้ว
  • iam.serviceAccounts.create: ต้องใช้เพื่อสร้างบัญชีบริการที่ลิงก์ไว้
  • iam.serviceAccountApiKeyBindings.create: เชื่อมโยงบัญชีบริการกับคีย์ API

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

คีย์ที่ไม่รู้จักในหน้าการใช้งาน

หน้าการใช้งานใน Google AI Studio จะจัดกลุ่มคำขอที่ไม่สามารถจับคู่กับคีย์ API ที่มีชื่อในโปรเจ็กต์ไว้ในส่วน(คีย์ที่ไม่รู้จัก) ซึ่งรวมถึงคีย์ที่ลบไปนานกว่า 30 วัน คีย์ที่ไม่มีชื่อที่แสดง และคำขอที่ส่งด้วยข้อมูลเข้าสู่ระบบอื่นๆ เช่น OAuth

การสร้างคีย์ในคอนโซล Google Cloud

Google AI Studio จะแสดงเฉพาะคีย์ที่ไม่จำกัดหรือจำกัดไว้สำหรับ Gemini API เท่านั้น หากใช้ AI Studio ไม่ได้ หรือต้องการจัดการคีย์ API ทั้งหมดในที่เดียว ให้ทำตามเอกสารประกอบของ Cloud เกี่ยวกับการสร้างคีย์ API การสร้างคีย์ Gemini API ต้องเชื่อมโยงกับบัญชีบริการ

กำลังตั้งค่าสภาพแวดล้อม

เมื่อมีคีย์แล้ว ให้กำหนดค่าสภาพแวดล้อมเพื่อใช้คีย์อย่างปลอดภัยในแอปพลิเคชัน

ตัวเลือกที่ 1: ใช้ตัวแปรสภาพแวดล้อม (แนะนำ)

ตั้งค่าตัวแปรสภาพแวดล้อม GEMINI_API_KEY หรือ GOOGLE_API_KEY ไลบรารีของไคลเอ็นต์ Gemini API จะตรวจหาและใช้ตัวแปรเหล่านี้โดยอัตโนมัติ หากตั้งค่าทั้ง 2 รายการ GOOGLE_API_KEY จะมีความสำคัญเหนือกว่า

เลือกระบบปฏิบัติการเพื่อตั้งค่าตัวแปร ดังนี้

Linux/macOS - Bash

ตรวจสอบว่าคุณมีไฟล์การกำหนดค่า bash หรือไม่ โดยทำดังนี้

~/.bashrc

หากยังไม่มี ให้สร้างและเปิดขึ้นมาโดยทำดังนี้

touch ~/.bashrc && open ~/.bashrc

เพิ่มคำสั่งส่งออกที่ส่วนท้ายของไฟล์ ดังนี้

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

บันทึกไฟล์ แล้วใช้การเปลี่ยนแปลงโดยทำดังนี้

source ~/.bashrc

macOS - Zsh

ตรวจสอบว่าคุณมีไฟล์การกำหนดค่า zsh หรือไม่ โดยทำดังนี้

~/.zshrc

หากยังไม่มี ให้สร้างและเปิดขึ้นมาโดยทำดังนี้

touch ~/.zshrc && open ~/.zshrc

เพิ่มคำสั่งส่งออก:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

บันทึกไฟล์ แล้วใช้การเปลี่ยนแปลงโดยทำดังนี้

source ~/.zshrc

Windows

  1. ค้นหา "ตัวแปรสภาพแวดล้อม" ในแถบค้นหาของ Windows
  2. คลิกตัวแปรสภาพแวดล้อมในกล่องโต้ตอบคุณสมบัติของระบบ
  3. ในส่วนตัวแปรของผู้ใช้หรือตัวแปรของระบบ ให้คลิกใหม่...
  4. ตั้งชื่อตัวแปรเป็น GEMINI_API_KEY และตั้งค่าเป็นคีย์ API ของคุณ
  5. คลิกตกลงเพื่อบันทึก เปิดเซสชันเทอร์มินัลใหม่เพื่อโหลดตัวแปร

ตัวเลือกที่ 2: ระบุคีย์ API อย่างชัดเจนในโค้ด

คุณสามารถส่งคีย์ API อย่างชัดแจ้งเมื่อเริ่มต้นไคลเอ็นต์ ทำเช่นนี้เฉพาะในกรณีที่คุณใช้ตัวแปรสภาพแวดล้อมไม่ได้เท่านั้น

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words"
)
print(interaction.output_text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.8-flash",
    input: "Explain how AI works in a few words",
  });
  console.log(interaction.output_text);
}

main();

Java

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = Client.builder().apiKey("YOUR_API_KEY").build();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey: "YOUR_API_KEY",
    })
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Explain how AI works in a few sentences."),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

REST

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

การรักษาความปลอดภัยและการจัดการ Secret Manager

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

กฎความปลอดภัยที่สำคัญ

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

แนวทางปฏิบัติแนะนำสำหรับการจัดการข้อมูลลับ

  • ตัวแปรสภาพแวดล้อม: อ่านคีย์จากตัวแปรสภาพแวดล้อมแทนไฟล์การกำหนดค่า
  • Secret Manager: สำหรับเวอร์ชันที่ใช้งานจริง ให้จัดเก็บคีย์ไว้ในที่เก็บข้อมูลลับที่ปลอดภัย เช่น Google Cloud Secret Manager
  • การแจ้งเตือนการเรียกเก็บเงิน: ตั้งค่าการแจ้งเตือนการเรียกเก็บเงินในคอนโซล Google Cloud เพื่อแจ้งให้คุณทราบหากการใช้งานหรือค่าใช้จ่ายเพิ่มขึ้นอย่างรวดเร็ว

รายการตรวจสอบการตอบสนองต่อการรั่วไหล

หากสงสัยว่าคีย์ API รั่วไหล ให้ทำดังนี้

  1. สร้างคีย์ใหม่: สร้างคีย์ทดแทนใน Google AI Studio หรือคอนโซล Cloud
  2. อัปเดตแอปพลิเคชัน: ติดตั้งใช้งานโค้ดโดยใช้คีย์ใหม่
  3. ปิดใช้หรือลบคีย์ที่ถูกบุกรุก: ปิดใช้คีย์ที่รั่วไหลในคอนโซล Cloud เมื่อยืนยันคีย์ใหม่แล้ว อย่าลบคีย์เก่าจนกว่าคีย์ใหม่จะทำงานอย่างเต็มรูปแบบเพื่อหลีกเลี่ยงช่วงที่แอปพลิเคชันหยุดทำงาน
  4. ตรวจสอบการใช้งาน: ตรวจสอบบันทึกการเรียกเก็บเงินและการใช้งาน API ในคอนโซล Google Cloud เพื่อระบุกิจกรรมที่ไม่ได้รับอนุญาต

การจำกัดและการรักษาความปลอดภัยคีย์

การเพิ่มข้อจำกัดให้กับคีย์ API จะช่วยลดความเสียหายที่อาจเกิดขึ้นหากคีย์ถูกบุกรุก

ใช้ข้อจำกัดต้นทางของคำขอ

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

  1. ไปที่หน้าข้อมูลเข้าสู่ระบบของคอนโซล Google Cloud
  2. เลือกโปรเจ็กต์ แล้วคลิกชื่อคีย์ API ที่ต้องการจำกัด
  3. ในส่วนข้อจำกัดของแอปพลิเคชัน ให้เลือกที่อยู่ IP (หรือประเภทข้อจำกัดที่เหมาะสมสำหรับสภาพแวดล้อมของคุณ)
  4. ระบุที่อยู่ IP หรือช่วงที่อนุญาต แล้วคลิกบันทึก

การรักษาความปลอดภัยคีย์ API มาตรฐานที่ไม่มีข้อจำกัด

หากต้องการใช้ Gemini API ต่อไป คุณต้องรักษาความปลอดภัยของคีย์ที่ไม่มีการจำกัด

วิธี ก: จำกัดคีย์ไว้สำหรับ Gemini API เท่านั้น (AI Studio)

หากใช้คีย์สำหรับ Gemini API เท่านั้น ให้รักษาความปลอดภัยของคีย์โดยตรงใน AI Studio โดยทำดังนี้

  1. ในหน้าคีย์ API ใน Google AI Studio ให้ค้นหาคีย์ที่มีป้ายกำกับไม่จำกัด
  2. วางเมาส์เหนือป้ายกำกับ แล้วคลิกเพิ่มข้อจำกัดในกล่องโต้ตอบ
  3. เลือกจำกัดเฉพาะ Gemini API เท่านั้น
  4. คลิกจำกัดคีย์เพื่อยืนยัน

วิธีที่ 2: จำกัดคีย์สำหรับบริการอื่นๆ (คอนโซล Google Cloud)

หากมีการแชร์คีย์กับ Google APIs อื่นๆ (ไม่แนะนำ) ให้จำกัดคีย์ในคอนโซล Cloud หมายเหตุ: คำขอ Gemini API ที่ใช้คีย์นี้จะดำเนินการไม่สำเร็จหลังจากใช้ข้อจำกัดเหล่านี้

  1. ไปที่หน้าข้อมูลเข้าสู่ระบบของคอนโซล Google Cloud
  2. เลือกโปรเจ็กต์และคีย์ API
  3. ในส่วนข้อจำกัดของ API ให้ใช้เมนูแบบเลื่อนลงเลือกข้อจำกัดของ API เพื่อเลือก API ที่คุณต้องการให้คีย์นี้เข้าถึง อย่าเลือก Generative Language API
  4. คลิกบันทึก สร้างคีย์ที่ถูกจำกัดแยกต่างหากใน AI Studio เพื่อใช้ Gemini API ต่อไป

คีย์ที่ไม่มีการใช้งานที่ถูกบล็อก

ตั้งแต่วันที่ 7 พฤษภาคม 2026 เป็นต้นไป Gemini API จะบล็อกคีย์ API ที่ไม่มีข้อจำกัดซึ่งไม่มีการใช้งานเป็นเวลานาน คีย์เหล่านี้จะแสดงแท็กถูกบล็อกใน AI Studio คุณต้องสร้างคีย์ใหม่หรือใช้คีย์ที่ถูกจำกัดที่มีอยู่เพื่อดำเนินการต่อ

ย้ายข้อมูลไปยังคีย์การตรวจสอบสิทธิ์

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

  1. ไปที่หน้าคีย์ API ของ AI Studio
  2. ตรวจสอบคอลัมน์ประเภทคีย์เพื่อระบุคีย์ที่แสดงเป็นมาตรฐาน
  3. คลิกสร้างคีย์ API เพื่อสร้างคีย์ใหม่ คีย์ใหม่ทั้งหมดที่สร้างใน AI Studio จะสร้างเป็นคีย์การตรวจสอบสิทธิ์โดยอัตโนมัติ
  4. คัดลอกคีย์ API การตรวจสอบสิทธิ์ใหม่
  5. อัปเดตโค้ดของแอปพลิเคชัน ตัวแปรสภาพแวดล้อม และการกำหนดค่าการติดตั้งใช้งานเพื่อใช้คีย์ API การตรวจสอบสิทธิ์ใหม่
  6. ทดสอบแอปพลิเคชันเพื่อยืนยันว่าทำงานร่วมกับคีย์ใหม่ได้อย่างถูกต้อง
  7. เมื่อยืนยันแล้ว ให้ลบหรือเพิกถอนคีย์การเข้าชมเดิมเพื่อป้องกันการใช้ในทางที่ผิด

ข้อจำกัด

Google AI Studio มีข้อจำกัดด้านการจัดการโปรเจ็กต์และคีย์ดังต่อไปนี้

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

สำหรับการจัดการโครงการขั้นสูงหรือการแก้ไขคีย์ที่มีข้อจำกัดอื่นๆ ให้ใช้หน้าข้อมูลเข้าสู่ระบบของคอนโซล Google Cloud