Obtén una clave de API

Para usar la API de Gemini, necesitas una clave de API. Puedes crear una clave con un clic en Google AI Studio.

Obtén una clave de API.

Verifica tu clave de API con un comando curl

Puedes usar un comando curl para verificar la configuración. Puedes pasar la clave de API en la URL:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

También puedes hacerlo en el encabezado x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

Protege tu clave de API

Es importante mantener segura 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 Google AI Gemini usa claves de API para la autorización. Si otras personas acceden a tu clave de API de Gemini, podrán realizar llamadas con la cuota de tu proyecto, lo que podría generar la pérdida de cuota o cargos de facturación adicionales (si la facturación está habilitada). Las claves de API también protegen el acceso a modelos y archivos ajustados.

  • Cuando haces clic en Obtener clave de API en Google AI Studio, eliges si deseas aprovisionar una clave de API de Gemini en un proyecto de Google Cloud nuevo o existente. En la lista de claves de API en Google AI Studio, se muestran todas las claves de API que AI Studio aprovisionó para usar con la API de Google AI Gemini (junto con todos sus proyectos de Google Cloud asociados).

    • Sin embargo, es posible que se use cualquier clave de API dentro del proyecto de Google Cloud para llamar a la API de Google AI Gemini. Puedes ver y administrar todas las claves de API de tu proyecto en el panel APIs y servicios > Credenciales en la consola de Google Cloud.

  • 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. De forma predeterminada, la clave de API de Gemini generada por Google AI Studio solo se puede usar con la API de Gemini de la IA de Google (oficialmente denominada "API de Generative Language" o generativelanguage.googleapis.com).

    • Si hay claves de API en tu proyecto de Google Cloud que carecen de restricciones de API o alguna clave de API que incluyó la API de Generative Language en la lista de entidades permitidas, esas claves se pueden usar con la API de Gemini de Google AI. La práctica recomendada es restringir cada clave de API solo a las APIs a las que llamas con ella.
    • Ten en cuenta que, incluso con las restricciones de la clave de API, si un actor malicioso obtiene tu clave de API, podrá usarla para realizar llamadas con la cuota de tu proyecto para todas las APIs incluidas en la lista de entidades permitidas de esa clave.

  • Eres responsable de mantener segura 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, la Web y Dart/Flutter) corren el riesgo de exponer las claves de API, por lo que no recomendamos usar los SDK cliente de la IA de Google en apps de producción para llamar a la API de Google AI Gemini directamente desde tus apps web y para dispositivos móviles. Consulta las guías de inicio rápido del SDK y conoce las prácticas recomendadas específicas del lenguaje para proteger tu clave de API.

Si quieres conocer algunas prácticas recomendadas generales, también puedes consultar este artículo de asistencia.

Próximos pasos