Obtén una clave de API de Gemini

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

Obtén una clave de API de Gemini en Google AI Studio

Configura tu clave de API

Para las pruebas iniciales, puedes codificar una clave de API de forma fija, pero esto solo debe ser temporal, ya que no es seguro. En el resto de esta sección, se explica cómo configurar tu clave de API de forma local como una variable de entorno con diferentes sistemas operativos.

Linux/macOS: Bash

Bash es una configuración común de la terminal de Linux y macOS. Para verificar si tienes un archivo de configuración, ejecuta el siguiente comando:

~/.bashrc

Si la respuesta es "No hay ningún archivo o directorio con ese nombre", deberás crear este archivo y abrirlo ejecutando los siguientes comandos o usar zsh:

touch ~/.bashrc
open ~/.bashrc

A continuación, debes configurar tu clave de API agregando el siguiente comando de exportación:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Después de guardar el archivo, ejecuta el siguiente comando para aplicar los cambios:

source ~/.bashrc

macOS: Zsh

Zsh es una configuración común de la terminal de Linux y macOS. Para verificar si tienes un archivo de configuración, ejecuta el siguiente comando:

~/.zshrc

Si la respuesta es "No hay ningún archivo o directorio con ese nombre", deberás crear este archivo y abrirlo ejecutando los siguientes comandos o usar bash:

touch ~/.zshrc
open ~/.zshrc

A continuación, debes configurar tu clave de API agregando el siguiente comando de exportación:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Después de guardar el archivo, ejecuta el siguiente comando para aplicar los cambios:

source ~/.zshrc

Windows

  1. Busca "Variables de entorno" en la configuración del sistema.
  2. Edita "Variables de usuario" (para el usuario actual) o "Variables del sistema" (para todos los usuarios; usa con precaución).
  3. Crea la variable y agrega export GEMINI_API_KEY=your_key_here.
  4. Aplique los cambios

Envía tu primera solicitud a la API de Gemini

Puedes usar un comando curl para verificar tu configuración:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Protege tu clave de API

Es importante mantener protegida tu clave de API de Gemini. A continuación, se muestran 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 (Android, Swift, 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 y para dispositivos móviles.

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