Gemini API: cómo obtener una clave, llamar al modelo y cuánto cuestan los tokens
El Gemini API es la forma en que llamas a los modelos Gemini desde tu propio código en lugar de una ventana de chat: un bot de soporte en tu sitio, un script que clasifica los tickets, finalización de código en un editor, una integración de CRM. La ruta clásica requiere una cuenta Google, configuración de facturación en la nube y una tarjeta extranjera. En NeuralSpace, el camino es más corto: se crea una clave en su panel de control en aproximadamente un minuto, se llama al modelo con una solicitud compatible con OpenAI y usted paga con un saldo simbólico, sin suscripción. A continuación se muestra una guía paso a paso: cómo obtener una clave, cómo es su primera llamada a Gemini 3.8 Flash y cuánto cuestan los tokens.
Qué es el Gemini API y quién lo necesita
Gemini es la familia de modelos de lenguaje de Google. A través del API está abierto a los desarrolladores: usted envía una serie de mensajes, obtiene una respuesta generada y la utiliza en su producto: se la muestra al usuario, la almacena y la procesa más. Casos de uso típicos: admitir chatbots, resumir correos electrónicos y documentos, extraer datos estructurados de texto, redactar contenido, automatizar rutinas en scripts. Gemini 3.8 Flash en el catálogo NeuralSpace es la rama rápida de la familia: un equilibrio de velocidad y precio que se adapta a los diálogos y al procesamiento masivo de textos.
Paso 1. Consigue una clave
- Regístrese el NeuralSpace con su correo electrónico; tardará menos de un minuto. A los nuevos usuarios se les acreditan tokens de inicio de inmediato, suficientes para las primeras API llamadas sin recarga.
- Abre el API página de claves en su tablero y cree una clave. La clave se parece a BLK0 y se muestra una vez; guárdela inmediatamente en un administrador de contraseñas o una variable de entorno, no en su repositorio.
- Consulta tu saldo: los modelos de texto requieren un mínimo de 50 tokens en la cuenta. Las recargas se realizan en el panel de control: sin tarjetas extranjeras ni tarifas de suscripción.
Paso 2. Llama al modelo
Gemini en público API funciona a través del punto final BLK1 compatible con OpenAI: el cuerpo lleva el modelo, una matriz BLK2 con roles de sistema/usuario/asistente y el límite BLK3. Una solicitud mínima de rizo:
BLK4
La respuesta vuelve en formato OpenAI: el texto generado está en BLK5, el uso real está en BLK6. Si ya tiene el código OpenAI SDK, cambian exactamente dos valores: base_url y la clave:
BLK7
Las interfaces de chat se benefician de la transmisión: agregue BLK8 y la respuesta llega en fragmentos a través de eventos enviados por el servidor, para que el usuario vea las primeras palabras antes de que se complete la generación.
Paso 3. Conoce lo que cuesta
La facturación se mide: los tokens de entrada (su aviso) y los tokens de salida (la respuesta del modelo) se cuentan por separado, cada uno con su propio precio por millón. Para Gemini 3.8 Flash, al momento de escribir este artículo, son 33,5 tokens por millón de entrada y 168 tokens por millón de salida. Una solicitud típica de "2000 tokens de contexto + 500 tokens de salida" cuesta alrededor de 0,15 tokens. El precio está vinculado al tipo de cambio y es flotante, así que consulte la tabla en vivo antes de hacer los cálculos: se publica en el API página de documentación y devuelto en formato legible por máquina por BLK9. A modo de comparación: DeepSeek V4 Flash en el mismo catálogo cuesta 21/42 tokens por millón, los modelos Claude son notablemente más caros; Gemini 3.8 Flash se ubica en el medio en precio y responde rápido.
Dos límites de servicio: 60 solicitudes por minuto por clave y un saldo mínimo de 50 tokens para modelos de texto. El saldo actual está disponible a través de BLK10, los cargos aparecen en el historial de transacciones de su perfil.
Gemini en el sitio: no se necesita código
Si aún no necesita el API, los mismos modelos se encuentran en la interfaz: elija Gemini 3.8 Flash en el charlar - la búsqueda web está habilitada allí - y para las imágenes el generación de imágenes La sección ofrece Nano Banana, un modelo basado en Gemini 2.5 Flash. El saldo es compartido: chatea y API retira de la misma cuenta.
Errores comunes de primera solicitud
- 401 No autorizado — la clave se pasó incorrectamente: un espacio adicional, un valor truncado, un prefijo incorrecto. La clave completa va después de BLK11 o en el encabezado BLK12.
- 429 Demasiadas solicitudes – alcanzas el límite de 60 solicitudes por minuto. Añade una pausa o una cola a tu lado.
- error de saldo — menos de 50 tokens en la cuenta: recargue en el panel y vuelva a intentarlo.
- Clave filtrada en git — manténgalo en variables de entorno (.env) y nunca lo confirme; si hay una fuga, vuelva a emitir la clave en la misma página de API claves.
Preguntas frecuentes
¿Necesito una cuenta Google o una tarjeta extranjera?
No. La clave se emite en su panel de NeuralSpace y usted paga desde un saldo de token: facturación basada en token, sin suscripción, sin facturación en la nube.
¿Cuánto cuesta una llamada Gemini API?
Solo los tokens reales: al momento de escribir este artículo, 33,5 tokens por millón de entrada y 168 por millón de salida para Gemini 3,8 Flash; una solicitud de un par de miles de tokens equivale aproximadamente a 0,15 tokens. Los precios actuales están en BLK13 y en la tabla de documentación.
¿Existe un nivel gratuito?
No hay generaciones libres en la plataforma. Los nuevos usuarios obtienen tokens iniciales, suficientes para los primeros experimentos, luego pagan por token sin tarifa de suscripción.
¿Qué más puede hacer el API además de enviar mensajes de texto?
Con la misma clave obtienes generación de imágenes, videos y música, síntesis y reconocimiento de voz y un servidor MCP en https://neuralspace.pro/mcp para agentes de IA. La lista completa de puntos finales se encuentra en la documentación.