Korzystanie z kluczy interfejsu Gemini API

Aby korzystać z interfejsu Gemini API, potrzebujesz klucza interfejsu API. Klucz możesz utworzyć bezpłatnie za pomocą kilku kliknięć w Google AI Studio.

Po uzyskaniu klucza interfejsu API możesz połączyć się z interfejsem Gemini API na te sposoby:

• Ustawianie klucza interfejsu API jako zmiennej środowiskowej
• Jawne podawanie klucza interfejsu API

Na potrzeby wstępnych testów możesz zakodować klucz interfejsu API na stałe, ale powinno to być tylko rozwiązanie tymczasowe, ponieważ nie jest bezpieczne. Przykłady zakodowania klucza interfejsu API znajdziesz w sekcji Jawne podawanie klucza interfejsu API.

Ustawianie klucza interfejsu API jako zmiennej środowiskowej

Jeśli ustawisz zmienną środowiskową GEMINI_API_KEY lub GOOGLE_API_KEY, klucz API zostanie automatycznie pobrany przez klienta podczas korzystania z jednej z bibliotek interfejsu Gemini API. Zalecamy ustawienie tylko jednej z tych zmiennych, ale jeśli ustawisz obie, pierwszeństwo będzie mieć zmienna GOOGLE_API_KEY.

Jeśli używasz interfejsu REST API lub JavaScript w przeglądarce, musisz podać klucz interfejsu API.

Poniżej znajdziesz instrukcje ustawiania klucza interfejsu API lokalnie jako zmiennej środowiskowejGEMINI_API_KEY w różnych systemach operacyjnych.

~/.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

Jawne podawanie klucza interfejsu API

W niektórych przypadkach możesz chcieć jawnie podać klucz interfejsu API. Na przykład:

• Wykonujesz proste wywołanie interfejsu API i wolisz zakodować klucz interfejsu API na stałe.
• Chcesz mieć pełną kontrolę i nie polegać na automatycznym wykrywaniu zmiennych środowiskowych przez biblioteki interfejsu Gemini API.
• Używasz środowiska, w którym zmienne środowiskowe nie są obsługiwane (np.internet), lub wykonujesz wywołania REST.

Poniżej znajdziesz przykłady, jak jawnie podać klucz interfejsu 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?key=$YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Zabezpiecz klucz interfejsu API

Traktuj klucz interfejsu Gemini API jak hasło. Jeśli zostaną one przejęte, inne osoby mogą wykorzystać limit projektu, ponieść opłaty (jeśli włączono płatności) i uzyskać dostęp do Twoich danych prywatnych, takich jak pliki.

Krytyczne reguły zabezpieczeń

• Nigdy nie przesyłaj kluczy interfejsu API do systemu kontroli wersji. Nie sprawdzaj klucza interfejsu API w systemach kontroli wersji, takich jak Git.

• Nigdy nie udostępniaj kluczy interfejsu API po stronie klienta. Nie używaj klucza interfejsu API bezpośrednio w aplikacjach internetowych ani mobilnych w wersji produkcyjnej. Klucze w kodzie po stronie klienta (w tym w naszych bibliotekach JavaScript/TypeScript i wywołaniach REST) można wyodrębnić.

Sprawdzone metody

• Używaj wywołań po stronie serwera z kluczami interfejsu API Najbezpieczniejszym sposobem używania klucza interfejsu API jest wywoływanie Gemini API z aplikacji po stronie serwera, w której klucz może być przechowywany w poufności.

• Używaj tokenów tymczasowych do uzyskiwania dostępu po stronie klienta (tylko interfejs Live API): w przypadku bezpośredniego dostępu do interfejsu Live API po stronie klienta możesz używać tokenów tymczasowych. Są one mniej ryzykowne pod względem bezpieczeństwa i mogą być używane w środowisku produkcyjnym. Więcej informacji znajdziesz w przewodniku dotyczącym tokenów tymczasowych.

• Rozważ dodanie ograniczeń do klucza: możesz ograniczyć uprawnienia klucza, dodając ograniczenia klucza interfejsu API. Minimalizuje to potencjalne szkody w przypadku wycieku klucza.

Ogólne sprawdzone metody znajdziesz też w tym artykule pomocy.