Cómo usar claves de API de Gemini

Para usar la API de Gemini, necesitas una clave de API. Puedes crear una clave de forma gratuita con unos pocos clics en Google AI Studio.

Una vez que tengas una clave de API, tendrás las siguientes opciones para conectarte a la API de Gemini:

• Establece tu clave de API como una variable de entorno
• Proporciona tu clave de API de forma explícita

Para las pruebas iniciales, puedes codificar una clave de API, pero esto solo debe ser temporal, ya que no es seguro. Puedes encontrar ejemplos para codificar la clave de API en Cómo proporcionar la clave de API de forma explícita.

Cómo configurar la clave de API como variable de entorno

Si configuras la variable de entorno GEMINI_API_KEY o GOOGLE_API_KEY, el cliente recogerá automáticamente la clave de API cuando use una de las bibliotecas de la API de Gemini. Te recomendamos que configures solo una de esas variables, pero si se configuran ambas, GOOGLE_API_KEY tiene prioridad.

Si usas la API de REST o JavaScript en el navegador, deberás proporcionar la clave de API de forma explícita.

A continuación, te mostramos cómo puedes configurar tu clave de API de forma local como la variable de entorno GEMINI_API_KEY con diferentes sistemas operativos.

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

Proporciona la clave de API de forma explícita

En algunos casos, es posible que desees proporcionar una clave de API de forma explícita. Por ejemplo:

• Estás realizando una llamada a la API simple y prefieres codificar la clave de API de forma fija.
• Quieres un control explícito sin tener que depender del descubrimiento automático de las variables de entorno por parte de las bibliotecas de la API de Gemini.
• Estás usando un entorno en el que no se admiten las variables de entorno (p. ej., la Web) o estás realizando llamadas REST.

A continuación, se incluyen ejemplos de cómo puedes proporcionar una clave de API de forma explícita:

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

Protege tu clave de API

Es importante proteger tu clave de API de Gemini. A continuación, se incluyen algunos aspectos que debes tener en cuenta cuando uses tu clave de API de Gemini:

• La API de Gemini de Google AI usa claves de API para la autorización. Si otras personas obtienen acceso a tu clave de API de Gemini, pueden realizar llamadas con la cuota de tu proyecto, lo que podría provocar la pérdida de la cuota o cargos adicionales para los proyectos facturados, además de acceder a modelos y archivos ajustados.

• Agregar restricciones de clave de API puede ayudar a limitar el área de superficie que se puede usar a través de cada clave de API.

• Eres responsable de proteger tu clave de API de Gemini.

  • NO registres las claves de API de Gemini en el control de código fuente.
  • Las aplicaciones del cliente (web y Dart/Flutter) corren el riesgo de exponer claves de API. No recomendamos usar los SDK de cliente de la IA de Google en apps de producción para llamar a la API de Gemini de la IA de Google directamente desde tus apps web.

Para conocer algunas prácticas recomendadas generales, también puedes revisar este artículo de asistencia.