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

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

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

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

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

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

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

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

การจัดการคีย์ 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 ใหม่ที่ไม่ได้เชื่อมโยงกับองค์กรเพื่อสร้างคีย์ได้

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

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

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

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

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

~/.bashrc

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

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

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

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

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

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

from google import genai

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

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

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.6-flash",
    input: "Explain how AI works in a few words",
  });
  console.log(interaction.output_text);
}

main();

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
    "google.golang.org/genai/interactions"
)

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

    interaction, err := client.Interactions.NewModel(ctx, interactions.NewModelParams{
        Model: "gemini-3.6-flash",
        Input: interactions.Input{
            String