Cómo configurar claves de API de Gemini para Discourse AI
Introducción
Este tema cubre cómo configurar su clave de API de Google Gemini con un proyecto de cuenta de Google Cloud existente. Gemini no es un servicio gratuito y, por lo tanto, deberá asegurarse de tener la facturación configurada en su administrador de Google Cloud.
Hay información importante con enlaces en la página de generación de claves de Gemini Developer studio sobre esto:
¡Ok, empecemos!
NOTA: Se requiere acceso a nivel de administrador a Google Cloud y a su foro de Discourse.
Paso 1: Configuración de un proyecto de Google Cloud
Configurar una clave de API de Gemini correctamente requiere que tenga acceso de administrador a su cuenta de Google Cloud y que cree un proyecto de facturación que pueda usar para el uso de su clave de API de Gemini.
Puede crear su clave en Gemini Studio y conectarla a su Google Cloud, pero es un poco más fácil hacerlo todo desde la consola de Google Cloud para no tener que ir y venir.
Vaya al administrador de Google Cloud para API de su organización y asegúrese de estar en la organización principal (puede verlo en el campo superior junto al logotipo de Google Cloud).
Tendrá que crear un proyecto para su clave Gemini si aún no tiene uno que desee utilizar (tenga en cuenta que el enlace para seleccionar o crear un nuevo proyecto está en la parte superior izquierda de la página).
Para un nuevo proyecto, complete la página de creación de nuevo proyecto (asegúrese de que su organización esté seleccionada en el campo desplegable apropiado).
Para gestionar la facturación de su proyecto, deberá configurar una cuenta de facturación para el proyecto en facturación de Google Cloud, asumiendo que tiene la facturación configurada para su organización. Usted (o su administrador de cuenta de facturación) debería poder hacer esto más tarde después de que se cree la clave. Tenga en cuenta que hay cuotas en proyectos y proyectos de facturación dependiendo de la cuenta de Google Cloud de su organización. Para habilitar la facturación en su proyecto, vaya a la pestaña Facturación en el menú de navegación de Google Cloud y vincule una cuenta de facturación (consulte el enlace “Administrar cuentas de facturación”) y habilite la facturación para el proyecto desde la página de proyectos de facturación.
Paso 2: Crear una clave de API de Gemini
¡IMPORTANTE! Recuerde utilizar sus claves de API de forma segura. Lea atentamente Mantenga segura su clave de API y Prácticas recomendadas para el uso seguro de claves de API antes de continuar.
Ahora está listo para crear una clave de API en el proyecto. Vaya a las credenciales para ese proyecto, haga clic en el enlace “+ crear credenciales” en la parte superior y seleccione “Clave de API” de las opciones desplegables.
Se creará una nueva clave de API para usted. Cópiela y asegúrela en un lugar seguro, como una aplicación de bóveda de contraseñas. No comparta claves. Esta es la clave que deberá introducir en la configuración de Discourse AI.
La clave debería aparecer ahora en sus claves de API. Haga clic en ella para editar la clave de API.
Asigne un nombre apropiado a la clave y luego vaya a la sección Restricciones de API y seleccione “Restringir clave”, luego elija “Generative Language API”.
Guarde su clave actualizada. Haga clic en el enlace “Mostrar clave” para su nueva clave y cópiela.
Paso 3: Configurar Gemini en la configuración de Discourse AI
Discourse AI ahora utiliza un sistema centralizado de Credenciales para administrar claves de API. En lugar de pegar su clave directamente en cada configuración de LLM, primero crea una credencial y luego la selecciona al configurar su modelo Gemini.
Paso 3a: Crear una credencial
Vaya a Administrador > Plugins > AI > Credenciales y haga clic en Nueva credencial. Asígnele un nombre descriptivo (por ejemplo, “Clave de API de Gemini”) y pegue la clave de API que copió de Google Cloud. Guarde la credencial.
Consejo: También puede crear una credencial en línea: al agregar un nuevo LLM en el siguiente paso, haga clic en el botón + junto al selector de credenciales para crear una sobre la marcha.
Paso 3b: Agregar un LLM de Gemini
Ahora vaya a Administrador > Plugins > AI > LLMs. Haga clic en Agregar y seleccione uno de los modelos Gemini preconfigurados (por ejemplo, Gemini 3 Flash o Gemini 3 Pro). El nombre del modelo, la URL del punto final y otras configuraciones se rellenarán previamente para usted. Utilice el menú desplegable Credencial para seleccionar la credencial que creó en el paso anterior y luego guarde.
Nota: La misma credencial se puede reutilizar en varias configuraciones de LLM, por lo que solo necesita introducir su clave de API de Gemini una vez.
Paso 4: Seguimiento del uso de la clave de API de Gemini
Puede realizar un seguimiento del uso de su clave de API de Gemini desde su panel de Google Cloud en facturación bajo “Administrar cuenta de facturación”
Y luego seleccione su proyecto específico de la lista de proyectos de facturación y le mostrará el informe de facturación donde puede especificar el(los) proyecto(s) y varios otros detalles que desea utilizar para rastrear sus proyectos de clave de API (también puede rastrear otras claves de API de Google adjuntas a su cuenta de Google Cloud aquí, por ejemplo, si tiene Google Custom Search API y Motor de Búsqueda Programable configurado).
