Conectar Gemini (Google): guía pantalla a pantalla
Tiempo: de 5 a 10 minutos con tu cuenta de Google. Coste: hay un nivel gratuito (con límites bajos) y el nivel de pago con créditos prepago (mínimo 5 US$, valen 12 meses, no reembolsables).
Pantalla 1 — Abrir Google AI Studio
1. Entra en aistudio.google.com/api-keys e inicia sesión con tu cuenta de Google.
2. Acepta los términos en el primer acceso.
Pantalla 2 — Proyecto
Cada clave pertenece a un proyecto de Google Cloud — es el que concentra la facturación y los límites.
- Primer acceso: AI Studio ya crea un proyecto predeterminado y una clave para ti.
- ¿Ya usas Google Cloud? Tus proyectos no aparecen solos. Ve a Dashboard → Projects → Import projects, busca el proyecto y haz clic en Import.
- Recomendado: usa un proyecto solo para la IA de atención (ej.: "atencion-ia"). Así el gasto y los límites quedan separados de otros sistemas de la empresa.
Pantalla 3 — Crear la clave ("Crear una clave nueva")
1. En la página API Keys (Claves de API), haz clic en Create API key (Crear clave de API).
2. Se abre la ventana "Crear una clave nueva":
- Ponle nombre a la clave: cambia "Gemini API Key" por Blocks2Work (así sabes para qué sirve).
- Elige un proyecto importado: elige el proyecto de la Pantalla 2. Si la lista está vacía o falta el proyecto, impórtalo primero (Pantalla 2).
3. Haz clic en Crear clave.
4. En la lista, haz clic en la clave creada y en el icono de copiar.
Pantalla 4 — Activar el nivel de pago (recomendado)
1. En la lista de claves (o en Projects), mira la columna Billing Tier / Plan del proyecto. Si está en Free, haz clic en Set up billing (Configurar facturación).
2. ¿Primera vez en Google Cloud? Elige el país, acepta los términos e indica contacto y tarjeta. ¿Ya tienes cuenta de facturación? Elige una existente o Add new billing account.
3. Haz la compra prepago (mínimo 5 US$). Algunas cuentas pueden elegir entre Prepay (prepago) y Postpay (factura a final de mes).
4. En aistudio.google.com/billing, activa la recarga automática (Setup auto-reload) y define un límite mensual de recargas.
5. Opcional: en aistudio.google.com/spend → Monthly spend cap → Edit spend cap, define un tope de gasto del proyecto.
Última pantalla: pegar la clave en Blocks2Work
1. En Blocks2Work, abre Ajustes → Integraciones y baja hasta Inteligencia artificial (o usa el botón Conectar mi cuenta de IA).
2. Elige el proveedor y pega la clave en el campo Clave de API.
3. Deja el modelo "rápido y barato" (es el ideal para atención al cliente) y ajusta el límite de respuestas al día — protege tu gasto.
4. Haz clic en Probar y conectar. Probamos la clave al momento: si aparece conectado en verde, ya está listo.
La clave se guarda cifrada y no vuelve a aparecer. Solo el propietario o un administrador de la cuenta puede conectarla.
Privacidad
Los mensajes que responde el Agente con IA se envían al proveedor elegido para generar la respuesta, según los términos de tu cuenta con ese proveedor. No pongas en "Información de la empresa" nada que no se pueda decir a un cliente.
¿Da error?
- 402 / sin créditos ("No credits"): el saldo prepago se ha acabado — compra créditos o activa la recarga automática (Pantalla 4).
- 429 / cuota: se alcanzó el límite del nivel gratuito — activa el nivel de pago (Pantalla 4) o espera.
- 403 / permiso / clave bloqueada: la clave está restringida a otra API o fue bloqueada. Crea una clave nueva en AI Studio.
- "Set up Prepay" en la columna de facturación: la cuenta de facturación existe, pero necesita la compra prepago para funcionar.
- Una cuenta de Google Cloud con pagos atrasados en otros servicios también suspende Gemini, aunque tenga crédito.
¿Todavía necesitas ayuda?
Escribe a [email protected] con una captura de pantalla (si hay un error). Respondemos en 1 día laborable.
Última actualización: 2026-10-31