Korzystanie z kluczy interfejsu Gemini API

Aby korzystać z interfejsu Gemini API, musisz mieć klucz API. W Google AI Studio możesz utworzyć klucz bezpłatnie, wykonując kilka kliknięć.

Po uzyskaniu klucza interfejsu API możesz nawiązać połączenie z interfejsem Gemini API na jeden z tych sposobów:

• Ustawianie klucza interfejsu API jako zmiennej środowiskowej
• Podanie klucza interfejsu API w prosty sposób

Podczas wstępnego testowania możesz zakodować na stałe klucz interfejsu API, ale powinno to być tylko tymczasowe, ponieważ nie jest to bezpieczne. Przykłady zakodowania klucza interfejsu API znajdziesz w sekcji Podawanie klucza interfejsu API w prosty sposób.

Ustawianie klucza interfejsu API jako zmiennej środowiskowej

Jeśli ustawisz zmienną środowiskową GEMINI_API_KEY lub GOOGLE_API_KEY, klucz interfejsu 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 obie są ustawione, pierwszeństwo ma zmienna GOOGLE_API_KEY.

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

Oto jak ustawić lokalnie klucz API jako zmienną środowiskowąGEMINI_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

Podawanie klucza interfejsu API w wyraźny sposób

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

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

Poniżej znajdziesz przykłady, jak 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"
          }
        ]
      }
    ]
  }'

Zabezpieczanie klucza interfejsu API

Pamiętaj, aby chronić klucz interfejsu Gemini API. Oto kilka kwestii, o których warto pamiętać, gdy korzystasz z klucza interfejsu Gemini API:

• Interfejs API Google AI Gemini używa kluczy API do autoryzacji. Jeśli inni użytkownicy uzyskają dostęp do klucza interfejsu Gemini API, mogą wykonywać wywołania, korzystając z limitu Twojego projektu. Może to spowodować utratę limitu lub dodatkowe opłaty za opłacane projekty, a także umożliwić dostęp do dostrojonych modeli i plików.

• Dodanie ograniczeń klucza interfejsu API może pomóc ograniczyć obszar, w którym można używać poszczególnych kluczy API.

• To Ty odpowiadasz za bezpieczeństwo klucza interfejsu Gemini API.

  • Nie sprawdzaj kluczy interfejsu Gemini API w kontroli źródłowej.
  • Aplikacje po stronie klienta (internetowe i Dart/Flutter) mogą ujawniać klucze API. Nie zalecamy używania pakietów SDK klienta Google AI w aplikacji produkcyjnej do wywoływania interfejsu Google AI Gemini API bezpośrednio z aplikacji internetowych.

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