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

หากต้องการใช้ Gemini API คุณต้องมีคีย์ API หน้านี้จะอธิบายวิธีสร้างและ จัดการคีย์ใน Google AI Studio รวมถึงวิธีตั้งค่าสภาพแวดล้อม เพื่อใช้คีย์ในโค้ด

คีย์ API

คีย์ API คือสตริงที่เข้ารหัสซึ่งคุณใช้ได้เมื่อเรียกใช้ Google Cloud API คุณสร้างและจัดการคีย์ Gemini API ทั้งหมดได้จากหน้าคีย์ API ของ Google AI Studio

เมื่อมีคีย์ API แล้ว คุณจะมีตัวเลือกต่อไปนี้ในการเชื่อมต่อกับ Gemini API

• การตั้งค่าคีย์ API เป็นตัวแปรสภาพแวดล้อม
• การระบุคีย์ API อย่างชัดเจน

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

โปรเจ็กต์ Google Cloud

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

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

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

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

หากยังไม่ได้นำเข้าโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้เพื่อนำเข้าโปรเจ็กต์ Google Cloud และสร้างคีย์

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

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

ข้อจำกัด

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

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

หากต้องการสิทธิ์เข้าถึงเพิ่มเติมเพื่อจัดการโปรเจ็กต์ ให้ไปที่ Google Cloud Console

การตั้งค่าคีย์ API เป็นตัวแปรสภาพแวดล้อม

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

หากใช้ REST API หรือ JavaScript ในเบราว์เซอร์ คุณจะต้องระบุคีย์ API อย่างชัดเจน

ต่อไปนี้คือวิธีตั้งค่าคีย์ API ในเครื่องเป็นตัวแปรสภาพแวดล้อม GEMINI_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

การระบุคีย์ API อย่างชัดเจน

ในบางกรณี คุณอาจต้องการระบุคีย์ API อย่างชัดเจน เช่น

• คุณกำลังทำการเรียก API อย่างง่ายและต้องการฮาร์ดโค้ดคีย์ API
• คุณต้องการควบคุมอย่างชัดเจนโดยไม่ต้องอาศัยการค้นพบตัวแปรสภาพแวดล้อมโดยอัตโนมัติจากไลบรารี Gemini API
• คุณกำลังใช้สภาพแวดล้อมที่ไม่รองรับตัวแปรสภาพแวดล้อม (เช่น เว็บ) หรือคุณกำลังทำการเรียก REST

ต่อไปนี้เป็นตัวอย่างวิธีระบุคีย์ API อย่างชัดเจน

from google import genai

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

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

package main

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

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)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-2.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-2.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

เก็บคีย์ API ไว้ในที่ปลอดภัย

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

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

• อย่านำคีย์ API ไปยังการควบคุมแหล่งที่มา อย่านำคีย์ API ไปไว้ในระบบควบคุมเวอร์ชัน เช่น Git

• อย่าเปิดเผยคีย์ API ในฝั่งไคลเอ็นต์ อย่าใช้คีย์ API โดยตรง ในเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ในเวอร์ชันที่ใช้งานจริง คีย์ในโค้ดฝั่งไคลเอ็นต์ (รวมถึงไลบรารี JavaScript/TypeScript และการเรียก REST) สามารถ ดึงข้อมูลได้

แนวทางปฏิบัติแนะนำ

• ใช้การเรียกฝั่งเซิร์ฟเวอร์ด้วยคีย์ API วิธีที่ปลอดภัยที่สุดในการใช้คีย์ API คือการเรียก Gemini API จากแอปพลิเคชันฝั่งเซิร์ฟเวอร์ที่สามารถเก็บคีย์ไว้เป็นความลับได้

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

• พิจารณาเพิ่มข้อจำกัดให้แก่คีย์: คุณจำกัดสิทธิ์ของคีย์ได้ โดยเพิ่มข้อจำกัดคีย์ API ซึ่งจะช่วยลดความเสียหายที่อาจเกิดขึ้นหากคีย์รั่วไหล

ดูแนวทางปฏิบัติแนะนำทั่วไปบางส่วนได้ในบทความสนับสนุนนี้