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

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

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

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

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

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

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

วิธีตั้งค่าคีย์ API ในพื้นที่เป็นตัวแปรสภาพแวดล้อม GEMINI_API_KEYด้วยระบบปฏิบัติการต่างๆ มีดังนี้

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

  1. ค้นหา "ตัวแปรสภาพแวดล้อม" ในการตั้งค่าระบบ
  2. แก้ไข "ตัวแปรผู้ใช้" (สําหรับผู้ใช้ปัจจุบัน) หรือ "ตัวแปรระบบ" (สําหรับผู้ใช้ทุกคน - ใช้ด้วยความระมัดระวัง)
  3. สร้างตัวแปรและเพิ่ม export GEMINI_API_KEY=your_key_here
  4. ใช้การเปลี่ยนแปลง

ระบุคีย์ API อย่างชัดแจ้ง

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

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

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

Python

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)

JavaScript

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();

Go

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

Java

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

REST

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

เก็บคีย์ API ให้ปลอดภัย

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

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

  • การเพิ่มข้อจำกัดของคีย์ API ช่วยจำกัดขอบเขตการใช้งานผ่านคีย์ API แต่ละคีย์ได้

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

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

คุณอ่านบทความสนับสนุนนี้เพื่อดูแนวทางปฏิบัติแนะนำทั่วไปบางส่วนได้ด้วย