Gemini API'yi kullanmak için API anahtarına ihtiyacınız vardır. Google Yapay Zeka Studio'da birkaç tıklamayla ücretsiz bir anahtar oluşturabilirsiniz.
API anahtarınız olduğunda Gemini API'ye bağlanmak için aşağıdaki seçeneklere sahip olursunuz:
İlk test için bir API anahtarını sabit kodlayabilirsiniz ancak bu, güvenli olmadığı için yalnızca geçici olmalıdır. API anahtarını sabit kodlamayla ilgili örnekleri API anahtarını açıkça sağlama bölümünde bulabilirsiniz.
API anahtarını ortam değişkeni olarak ayarlama
GEMINI_API_KEY
veya GOOGLE_API_KEY
ortam değişkenini ayarlarsanız Gemini API kitaplıklarından biri kullanılırken API anahtarı istemci tarafından otomatik olarak alınır. Bu değişkenlerden yalnızca birini ayarlamanız önerilir. Ancak her ikisi de ayarlanmışsa GOOGLE_API_KEY
önceliklidir.
Tarayıcıda REST API'yi veya JavaScript'i kullanıyorsanız API anahtarını açıkça sağlamanız gerekir.
API anahtarınızı farklı işletim sistemlerinde yerel olarak ortam değişkeni GEMINI_API_KEY
olarak nasıl ayarlayabileceğinizi aşağıda bulabilirsiniz.
Linux/macOS - Bash
Bash, yaygın bir Linux ve macOS terminal yapılandırmasıdır. Aşağıdaki komutu çalıştırarak bunun için bir yapılandırma dosyanız olup olmadığını kontrol edebilirsiniz:
~/.bashrc
Yanıt "Böyle bir dosya veya dizin yok" ise bu dosyayı oluşturup aşağıdaki komutları çalıştırarak açmanız veya zsh
kullanmanız gerekir:
touch ~/.bashrc
open ~/.bashrc
Ardından, aşağıdaki dışa aktarma komutunu ekleyerek API anahtarınızı ayarlamanız gerekir:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>
Dosyayı kaydettikten sonra aşağıdaki komutu çalıştırarak değişiklikleri uygulayın:
source ~/.bashrc
macOS - Zsh
Zsh, yaygın bir Linux ve macOS terminal yapılandırmasıdır. Aşağıdaki komutu çalıştırarak bunun için bir yapılandırma dosyanız olup olmadığını kontrol edebilirsiniz:
~/.zshrc
Yanıt "Böyle bir dosya veya dizin yok" ise bu dosyayı oluşturup aşağıdaki komutları çalıştırarak açmanız veya bash
kullanmanız gerekir:
touch ~/.zshrc
open ~/.zshrc
Ardından, aşağıdaki dışa aktarma komutunu ekleyerek API anahtarınızı ayarlamanız gerekir:
export GEMINI_API_KEY=<YOUR_API_KEY_HERE>
Dosyayı kaydettikten sonra aşağıdaki komutu çalıştırarak değişiklikleri uygulayın:
source ~/.zshrc
Windows
- Sistem ayarlarında "Ortam Değişkenleri"ni arayın
- "Kullanıcı değişkenleri"ni (mevcut kullanıcı için) veya "Sistem değişkenleri"ni (tüm kullanıcılar için - dikkatli kullanın) düzenleyin.
- Değişkeni oluşturun ve
export GEMINI_API_KEY=your_key_here
ekleyin - Değişiklikleri uygulama
API anahtarını açıkça sağlama
Bazı durumlarda API anahtarını açıkça belirtmek isteyebilirsiniz. Örneğin:
- Basit bir API çağrısı yapıyorsanız ve API anahtarını sabit kodlamayı tercih ediyorsanız.
- Gemini API kitaplıkları tarafından ortam değişkenlerinin otomatik olarak keşfedilmesine güvenmek zorunda kalmadan açık kontrol sahibi olmak istiyorsanız
- Ortam değişkenlerinin desteklenmediği bir ortam (ör.web) kullanıyorsanız veya REST çağrıları yapıyorsanız.
Aşağıda, API anahtarını açıkça nasıl sağlayabileceğinize dair örnekler verilmiştir:
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 anahtarınızın güvenliğini sağlama
Gemini API anahtarınızın güvenliğini sağlamanız önemlidir. Gemini API anahtarınızı kullanırken aklınızda bulundurmanız gereken bazı noktalar aşağıda belirtilmiştir:
Google AI Gemini API, yetkilendirme için API anahtarları kullanır. Gemini API anahtarınıza erişen diğer kullanıcılar, projenizin kotasını kullanarak çağrı yapabilir. Bu durum, ayarlanmış modellere ve dosyalara erişmenin yanı sıra faturalandırılan projeler için kota kaybına veya ek ücretlere neden olabilir.
API anahtarı kısıtlamaları eklemek, her API anahtarı aracılığıyla kullanılabilen alanı sınırlandırmaya yardımcı olabilir.
Gemini API anahtarınızın güvenliğini sağlamak sizin sorumluluğunuzdadır.
- Gemini API anahtarlarını kaynak denetimine KAYDETMEYİN.
- İstemci tarafı uygulamalarda (web ve Dart/Flutter) API anahtarlarının açığa çıkma riski vardır. Google AI Gemini API'yi doğrudan web uygulamalarınızdan çağırmak için üretim uygulamalarında Google AI istemci SDK'larını kullanmanızı önermiyoruz.
Genel en iyi uygulamalar için bu destek makalesini de inceleyebilirsiniz.