Como usar chaves da API Gemini

Para usar a API Gemini, você precisa de uma chave de API. Você pode criar uma chave sem custo financeiro com alguns cliques no Google AI Studio.

Depois de ter uma chave de API, você tem as seguintes opções para se conectar à API Gemini:

• Definir a chave de API como uma variável de ambiente
• Fornecer a chave de API explicitamente

Para o teste inicial, você pode codificar uma chave de API, mas isso deve ser temporário, já que não é seguro. Confira exemplos de como codificar a chave de API em Como fornecer a chave de API explicitamente.

Como definir a chave de API como variável de ambiente

Se você definir a variável de ambiente GEMINI_API_KEY ou GOOGLE_API_KEY, a chave de API será detectada automaticamente pelo cliente ao usar uma das bibliotecas da API Gemini. É recomendável definir apenas uma dessas variáveis, mas se ambas forem definidas, GOOGLE_API_KEY terá precedência.

Se você estiver usando a API REST ou JavaScript no navegador, será necessário fornecer a chave de API explicitamente.

Veja como definir a chave de API localmente como a variável de ambiente GEMINI_API_KEY com diferentes sistemas operacionais.

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

Fornecer a chave de API explicitamente

Em alguns casos, é necessário fornecer uma chave de API explicitamente. Exemplo:

• Você está fazendo uma chamada de API simples e prefere codificar a chave de API.
• Você quer controle explícito sem depender da descoberta automática de variáveis de ambiente pelas bibliotecas da API Gemini.
• Você está usando um ambiente em que as variáveis de ambiente não têm suporte (por exemplo, Web) ou está fazendo chamadas REST.

Confira abaixo exemplos de como fornecer uma chave de API explicitamente:

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"
          }
        ]
      }
    ]
  }'

Proteger a chave de API

É importante manter a chave da API Gemini segura. Confira alguns pontos a serem considerados ao usar a chave da API Gemini:

• A API Gemini da IA do Google usa chaves de API para autorização. Se outras pessoas tiverem acesso à chave da API Gemini, elas poderão fazer chamadas usando a cota do seu projeto, o que pode resultar na perda da cota ou em cobranças adicionais para projetos faturados, além de acessar modelos e arquivos ajustados.

• Adicionar restrições de chave de API pode ajudar a limitar a área utilizável em cada chave de API.

• Você é responsável por manter a chave da API Gemini segura.

  • NÃO registre as chaves da API Gemini no controle da origem.
  • Os aplicativos do lado do cliente (Web e Dart/Flutter) correm o risco de expor chaves de API. Não recomendamos usar os SDKs de cliente da IA do Google em apps de produção para chamar a API Gemini da IA do Google diretamente dos seus apps da Web.

Para conferir algumas práticas recomendadas gerais, consulte este artigo de suporte.