หากต้องการใช้ 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
- ค้นหา "ตัวแปรสภาพแวดล้อม" ในการตั้งค่าระบบ
- แก้ไข "ตัวแปรผู้ใช้" (สําหรับผู้ใช้ปัจจุบัน) หรือ "ตัวแปรระบบ" (สําหรับผู้ใช้ทุกคน - ใช้ด้วยความระมัดระวัง)
- สร้างตัวแปรและเพิ่ม
export GEMINI_API_KEY=your_key_here
- ใช้การเปลี่ยนแปลง
ระบุคีย์ 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 จากเว็บแอปโดยตรง
คุณอ่านบทความสนับสนุนนี้เพื่อดูแนวทางปฏิบัติแนะนำทั่วไปบางส่วนได้ด้วย