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 tu 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}"

O 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"

Mantén segura tu clave de API

Es importante mantener segura tu clave de API de Gemini. Estos son algunos aspectos que debes tener en cuenta cuando uses tu clave de API de Gemini:

  • La API de Gemini de IA de Google usa claves de API para la autorización. Si otras personas obtienen acceso a tu clave de API de Gemini, pueden realizar llamadas usando la cuota de tu proyecto, lo que podría provocar la pérdida de cuota o cargos de facturación adicionales (si la facturación es habilitado). 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. El Lista de claves de API en Google AI Studio muestra todas las claves de API que AI Studio aprovisionó para usar con la API de Google la API de Gemini para IA (junto con todos sus proyectos de Google Cloud asociados).

    • Sin embargo, cualquier clave de API dentro del proyecto de Google Cloud puede se usa para llamar a la API de Gemini de la IA de Google. Puedes ver y administrar todas tus claves de API de tu proyecto en la APIs y Servicios > Panel de credenciales en la consola de Google Cloud.

  • Agregando Restricciones de la clave de API puede ayudar a limitar el área de superficie que puede usarse a través de cada clave de API. De forma predeterminada, el La clave de API de Gemini generada por Google AI Studio solo se puede usar con la IA de Google API de Gemini (llamada oficialmente “API de Generative Language” o generativelanguage.googleapis.com).

    • Si hay claves de API en tu proyecto de Google Cloud que no tienen APIs restricciones o cualquier clave de API que incluya API, se pueden usar esas claves con la API de Gemini de Google AI. Es lo mejor práctica restringir cada clave de API únicamente a las APIs a las que llames usando esa .
    • Ten en cuenta que incluso con restricciones de clave de API, si un agente malicioso obtiene tu clave de API, pueden usarla para hacer llamadas con la cuota de tu proyecto las APIs incluidas en la lista de entidades permitidas para esa clave.

  • Es tu responsabilidad mantener segura la clave de API de Gemini.

    • NO registres las claves de API de Gemini en el control de código fuente.
    • Riesgo de aplicaciones del cliente (Android, Swift, Web y Dart/Flutter) 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 Gemini de Google AI directamente desde tu aplicaciones web y para dispositivos móviles. Consulta las guías de inicio rápido del SDK para obtener información prácticas recomendadas específicas de cada lenguaje para proteger tu clave de API.

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

Próximos pasos