En esta guía, se proporciona una descripción general de las diferentes opciones de facturación de la API de Gemini, se explica cómo habilitar la facturación y supervisar el uso, y se brindan respuestas a las preguntas frecuentes sobre la facturación.
Acerca de la facturación y los niveles
La facturación de la API de Gemini se basa en tu historial de pagos.
| Nivel de uso | Calificación | Límite del nivel de facturación |
|---|---|---|
| Gratis | Proyecto activo o prueba gratuita | N/A |
| Nivel 1 | Configura y vincula una cuenta de facturación activa | $250 |
| Nivel 2 | Se pagaron USD 100 y se agregaron 3 días a partir del primer pago exitoso | $2,000 |
| Nivel 3 | Se pagaron USD 1,000 + 30 días a partir del primer pago exitoso | De USD 20,000 a más de USD 100,000 |
Las cuentas nuevas comienzan con el nivel gratuito, que permite el acceso a ciertos modelos en la API de Gemini y AI Studio, hasta los límites de frecuencia del nivel gratuito de los modelos.
Para acceder a límites de frecuencia más altos, usar modelos avanzados y asegurarte de que tus instrucciones y respuestas no se usen para mejorar los productos de Google*, puedes vincular una cuenta de facturación y pagar por adelantado para cambiar a los niveles pagados. Luego, avanzarás a niveles superiores según la inversión acumulada y la antigüedad de la cuenta. En el nivel 3, es posible que tengas la opción de cambiar a la facturación pospago.
Los niveles, los límites de frecuencia y los topes de la cuenta de facturación se determinan a nivel de la cuenta de facturación.
* Privacidad de datos de nivel empresarial: Para obtener más información sobre el uso de datos para los servicios pagados, consulta las Condiciones del Servicio.
Configura la facturación para acceder al nivel pagado
Puedes crear un proyecto y configurar la facturación, o importar un proyecto existente, para actualizarlo al nivel pagado en Google AI Studio. Actualizar del nivel gratuito al nivel pagado implica vincular una cuenta de facturación y pagar por adelantado para agregar un mínimo de USD 10 (o el equivalente en otras monedas) de créditos a tu cuenta.
- Ve a la página Claves de API o Proyectos de AI Studio, o a cualquier lugar en el que veas el botón Configurar facturación en AI Studio.
- De forma predeterminada, los usuarios nuevos tendrán un proyecto y una clave de API creados para ellos.
- Si necesitas una clave nueva, haz clic en Crear clave de API y sigue los pasos del diálogo para agregar un par clave-proyecto a la tabla.
- Busca el proyecto del nivel gratuito que deseas actualizar al nivel pagado y haz clic en Configurar facturación en la columna Nivel de facturación.
- Si nunca configuraste una cuenta de facturación de Google, haz lo siguiente:
- Se te pedirá que selecciones tu país para aceptar las Condiciones del Servicio.
- Luego, completa o confirma tu información de contacto y forma de pago para continuar.
- Si ya configuraste cuentas de facturación de Google en el pasado, haz lo siguiente:
- Se te pedirá que elijas entre tus cuentas de facturación existentes.
- Si no quieres usar ninguna de tus cuentas existentes, haz clic en Agregar una nueva cuenta de facturación y completa o confirma tu información de contacto y forma de pago para continuar.
- A continuación, ocurrirá una de las siguientes situaciones:
- Se te solicitó que prepagues un mínimo de USD 10 para completar la configuración de facturación (lo que significa que tu cuenta se asignó automáticamente al plan de facturación de prepago).
- Se te ofrece la opción de elegir entre los planes de facturación Prepago y Pospago para tu cuenta.
- Se asignará a un plan de facturación pospago durante un período intermedio hasta que el nuevo sistema de prepago se propague a todos los usuarios (a partir del 23 de marzo de 2026).
- Después de seleccionar la opción de prepago o pospago, se completará la configuración de tu cuenta.
Actualiza al siguiente nivel pagado
Si ya estás en un nivel pagado y cumples con los criterios para cambiar de plan, se te actualizará automáticamente al siguiente nivel (sujeto a los tiempos de procesamiento).
Verifica el estado de la facturación
Después de vincular una cuenta de facturación a tu proyecto, puedes supervisar su estado en la página Facturación de AI Studio. A diferencia del nivel gratuito, el estado del nivel pagado es dinámico. Si bien tu nivel de uso se determina según el historial de tu cuenta, la API de Gemini solo atenderá solicitudes si tienes un saldo de crédito prepago positivo.
En la página Proyectos, podrás ver el nivel y el plan de facturación de tu proyecto en la columna Nivel de facturación. Las acciones de estado de facturación que debas realizar para un proyecto se mostrarán en las columnas Nivel de facturación o Estado:
- “Configurar la facturación” si el proyecto no tiene una cuenta de facturación adjunta
- "Configurar prepago" si el proyecto tiene una cuenta de facturación adjunta, pero se requiere usar un plan de facturación de prepago que debe configurarse.
- "No hay créditos disponibles" si se requiere una cuenta de facturación para comprar créditos, pero no se configuró la cuenta de pagos de prepago o se agotó el saldo de crédito disponible.
Haz clic en cualquiera de los mensajes para continuar con las acciones necesarias.
Supervisa el uso
Puedes supervisar el uso de la API de Gemini en Google AI Studio en Panel > Uso.
Planes de facturación
Los planes de facturación de la API de Gemini y AI Studio se dividen en dos categorías que determinan cuándo pagas por el uso: prepago y pospago. Puedes consultar el plan de facturación asignado y administrar las formas de pago en la página Facturación de AI Studio.
Prepago
En el plan de facturación prepagada, compras créditos para tu saldo prepagado antes de usar la API de Gemini, y los costos de uso de la API se deducen de tu saldo de crédito prepagado casi en tiempo real. Puedes realizar el pago por adelantado agregando créditos a tu cuenta o configurando la recarga automática. Después de comprar créditos, los que no se usen vencerán después de 12 meses y no se reembolsarán, excepto después de cambiar a una cuenta de pospago.
Cuando el saldo de crédito de prepago de la cuenta de facturación llegue a USD 0, todas las claves de API de todos los proyectos vinculados a esa cuenta de facturación dejarán de funcionar simultáneamente. Los créditos prepagados solo se aplican a los costos de uso de la API de Gemini. No puedes usarlos para pagar otros servicios de Google Cloud.
De forma predeterminada, los usuarios nuevos se registran en el plan de facturación de prepago. Es posible que los proyectos anteriores a la introducción de los planes de facturación prepago y pospago deban actualizar los detalles de facturación del proyecto antes de seguir usando la API de Gemini.
Compre créditos
Puedes comprar créditos de forma manual antes de usar la API de Gemini para cargarlos en el saldo de crédito de tu cuenta prepagada.
Para comprar créditos, ve a la página Facturación de AI Studio y selecciona Comprar créditos. La compra mínima es de USD 10. El importe máximo de créditos que puedes pagar por adelantado es de USD 5,000.
Volver a cargar automáticamente
La recarga automática es una función opcional que recarga automáticamente tu saldo de crédito prepagado cuando se está agotando. Esto es útil para evitar interrupciones del servicio.
Puedes configurar la recarga automática y ver su estado en la tarjeta Créditos disponibles de la página Facturación de AI Studio. Haz clic en Configurar recarga automática o Administrar recarga automática para establecer tu forma de pago, el importe de recarga y el saldo mínimo que activa un pago de recarga.
Pospago
En el plan de facturación pospago, tu cuenta de facturación de Cloud acumula costos y se te cobra automáticamente al final del mes o cuando tus costos alcanzan un importe límite asignado automáticamente. El pago se cobra a la forma de pago asociada a tu cuenta de pagos de Postpay, que puedes administrar en la página Facturación de AI Studio.
Cuando cumples con los criterios del nivel 3, puedes cambiar manualmente del plan prepagado al pospagado. Para cambiar de plan, deberás hacer clic en el botón Cambiar a pospago que aparece en la esquina superior derecha de la página Facturación de AI Studio cuando tu cuenta cumpla con los requisitos.
Luego, en la página Facturación, podrás ver tu saldo, las fechas de vencimiento y los pagos anteriores, así como realizar pagos y administrar las formas de pago.
Cuando configures la facturación para un proyecto nuevo, si cumples con los requisitos para el pospago, tendrás la opción de elegir entre prepago y pospago en el diálogo de configuración de facturación.
Después de cambiar una cuenta de Facturación de Cloud para que use el plan de facturación con posterioridad al uso, todos los proyectos vinculados a esa cuenta de facturación se cambiarán al plan con posterioridad al uso. No puedes volver a cambiar esa cuenta de facturación al plan de facturación de prepago. Puedes trasladar un proyecto a una cuenta de facturación con un plan de facturación diferente para cambiar el ciclo de facturación de ese proyecto. Visita la documentación de Cloud sobre la administración de la facturación de proyectos.
Puedes obtener más información sobre el ciclo de cobro de Postpago en la guía de Facturación de Cloud.
Límites de inversión
La API de Gemini admite límites de inversión mensuales a nivel de la cuenta de facturación y del proyecto. Estos controles están diseñados para proteger tu cuenta de cargos inesperados y el ecosistema para garantizar la disponibilidad del servicio.
Límites de inversión del proyecto
Puedes establecer tus propios límites de inversión a nivel del proyecto en AI Studio. Esto es útil si tienes varios proyectos en la misma cuenta de facturación y deseas asegurarte de que cada uno tenga acceso a una cantidad suficiente del límite de gasto acumulativo.
Las cuentas con roles de editor, propietario o administrador del proyecto pueden establecer límites de inversión por proyecto en AI Studio en la página Inversión en Límite de inversión mensual > Editar límite de inversión.
Si trasladas un proyecto a una cuenta de facturación diferente, se mantendrá cualquier límite de inversión que ya hayas establecido para ese proyecto, pero la inversión acumulada se restablecerá a USD 0 para el nuevo ciclo de facturación.
Las finalizaciones en modo por lotes aún pueden generar cargos por excedentes.
Los tiempos de procesamiento de los datos de facturación pueden retrasarse ligeramente en AI Studio, hasta unos 10 minutos. Es posible que experimentes excedentes más allá del límite de tu proyecto si los datos de facturación no se procesan antes de que se acumulen más cargos.
Límites de inversión de los niveles de la cuenta de facturación
Cada nivel tiene un límite de inversión mensual máximo:
| Nivel de uso | Límite de inversión |
|---|---|
| Gratis | N/A |
| Nivel 1 | $250 |
| Nivel 2 | $2,000 |
| Nivel 3 | USD 20,000 a USD 100,000 |
Los límites de uso mensuales se aplican a nivel de la cuenta de facturación, están preestablecidos y no se pueden configurar. La inversión total se agrega en todos los proyectos vinculados. Después de que el total acumulado alcanza el límite del nivel, se suspende el servicio para todos los proyectos vinculados a esa cuenta de facturación hasta el inicio del siguiente ciclo de facturación (mensual).
Evalúa la inversión de tu cuenta de facturación
Para evaluar tu inversión mensual histórica y determinar si los nuevos límites de inversión de nivel de la cuenta de facturación afectarán tus proyectos en curso, sigue estos pasos:
- En la consola de Google Cloud, consulta la página Informes de tu cuenta de Facturación de Cloud.
- Si tienes más de una cuenta de facturación, en el mensaje, elige la cuenta de Facturación de Cloud para la que deseas ver los informes de costos.
- De forma predeterminada, el informe se establece en "Agrupar por servicio" en el "Mes actual". Verás Gemini API en la columna Servicio y la inversión total en la columna Costo de uso de la tabla.
- Para ver los costos detallados limitados al uso de la API de Gemini, configura el filtro Agrupar por para agrupar por SKU y el filtro Servicios en API de Gemini.
- Ajusta el filtro Período por fecha de uso al período que desees para evaluar tu inversión histórica en un período.
Tiempos de procesamiento
Los indicadores y las actualizaciones de facturación no siempre se realizan en tiempo real.
- Uso de créditos: Por lo general, los costos de uso se deducen de tu saldo en cuestión de minutos.
- Confirmación del pago: Si bien la mayoría de los pagos con tarjeta son instantáneos, algunas formas de pago (como las transferencias bancarias) pueden tardar varios días en procesarse. Los servicios solo se reanudan o actualizan después de que se confirma oficialmente la compra de créditos.
- Actualizaciones de nivel: Después de un pago exitoso o cuando cumples con los criterios de actualización, las actualizaciones de nivel suelen reflejarse en un plazo de 10 minutos.
- Gráficos de desglose del costo total: Los gráficos que muestran el desglose del costo total en las páginas Facturación y Inversión pueden tardar hasta 24 horas en actualizarse.
Consulta las guías de Facturación de Cloud sobre el ciclo de facturación y las latencias de transacciones para obtener más información sobre posibles demoras en la facturación.
Reembolsos
No se permiten reembolsos para las cuentas de facturación de prepago. Los créditos comprados vencen después de 1 año. Después del vencimiento, los créditos se pierden y no se pueden recuperar.
Cuando una cuenta prepagada cambia al tipo de cuenta pospagada (después de que cumples con los criterios y actualizas manualmente tu cuenta), la cuenta prepagada se cierra y los créditos prepagados restantes se reembolsan automáticamente a la forma de pago registrada.
Si cierras tu cuenta de prepago por cualquier motivo que no sea actualizar a la modalidad de pospago, se perderán los créditos prepagados restantes.
Las cuentas de pospago cumplen con la política de reembolsos de Google Cloud.
Cuentas de facturación de Cloud
La API de Gemini usa cuentas de Facturación de Cloud para los servicios de facturación, que puedes configurar directamente en AI Studio. Puedes usar AI Studio para hacer un seguimiento de los gastos, comprender los costos y realizar pagos.
Los niveles, los límites de frecuencia y los límites de las cuentas de facturación se determinan a nivel de la cuenta de facturación.
Proyectos y claves de API
Todos los proyectos vinculados a una cuenta de Facturación de Cloud heredan el nivel de uso y los límites de tarifas y los límites de cuenta asociados de la cuenta de facturación. Si cambias un proyecto de una cuenta de facturación a otra, su nivel y, posteriormente, los límites de frecuencia y los límites de la cuenta cambiarán al nivel de la nueva cuenta de facturación.
El gasto acumulado (en todos los productos de Google Cloud) y la antigüedad de la cuenta en todos los proyectos vinculados a una cuenta de facturación se tienen en cuenta para las calificaciones de nivel de esa cuenta de facturación.
Puedes desvincular un proyecto de su cuenta de facturación para volver al nivel gratuito.
Las claves de API son credenciales que se generan dentro de un proyecto. No tienen parámetros de configuración de facturación independientes, sino que heredan los límites de nivel y el estado de facturación del proyecto. El uso acumulativo de todas las claves de un proyecto se incluye en el límite de inversión de ese proyecto y en la inversión total de la cuenta de facturación.
Preguntas frecuentes
En las siguientes secciones, se proporcionan respuestas a las preguntas frecuentes.
¿Qué me cobran?
Los precios de la API de Gemini se basan en lo siguiente:
- La cantidad de tokens de entrada
- La cantidad de tokens de salida
- La cantidad de tokens almacenados en caché
- La duración del almacenamiento de los tokens en caché
Para obtener información sobre los precios, consulta la página de precios.
¿Dónde puedo ver mi cuota?
Puedes ver tus límites de cuota y del sistema en AI Studio.
¿Cómo puedo solicitar más cuota?
Se te otorgará automáticamente más cuota cuando tu cuenta alcance los próximos requisitos de nivel.
¿Puedo usar la API de Gemini de forma gratuita en el EEE (incluida la UE), el Reino Unido y Suiza?
Sí, ofrecemos el nivel gratuito y el nivel pagado en muchas regiones.
Si configuro la facturación con la API de Gemini, ¿se me cobrará por mi uso de Google AI Studio?
El uso de AI Studio sigue siendo gratuito, a menos que los usuarios vinculen una clave de API pagada para acceder a las funciones pagadas. Una vez que vincules una clave de API pagada como parte de un proyecto pagado en AI Studio, se te cobrará el uso de AI Studio para esa clave. Puedes cambiar entre proyectos del nivel pagado y proyectos del nivel gratuito en AI Studio según sea necesario.
¿Puedo usar 1 millón de tokens en el nivel gratuito?
El nivel gratuito de la API de Gemini varía según el modelo seleccionado. Por el momento, puedes probar la ventana de contexto de 1 millón de tokens de las siguientes maneras:
- En Google AI Studio
- Con planes sin cargo para modelos seleccionados
- Con planes pospagos
¿Cómo puedo calcular la cantidad de tokens que uso?
Usa el método GenerativeModel.count_tokens para contar la cantidad de tokens. Consulta la guía de tokens para obtener más información sobre ellos.
¿Puedo usar mi crédito de bienvenida de Google Cloud con la API de Gemini?
No, el crédito de bienvenida o el crédito de prueba gratuita de Google Cloud no se pueden usar para la API de Gemini ni AI Studio.
Si se te otorgó un crédito de bienvenida de Google Cloud antes de que dejaras de cumplir con los requisitos, puedes usar los créditos restantes en la API de Gemini y en AI Studio hasta que venzan después de 90 días.
¿Cómo se maneja la facturación?
La facturación de la API de Gemini se controla con el sistema de facturación de Cloud. Obtén más información sobre la configuración de la Facturación de Cloud en el producto en la documentación de la Facturación de Cloud.
¿Se me cobra por las solicitudes con errores?
Si tu solicitud falla con un error 400 o 500, no se te cobrarán los tokens que se usaron. Sin embargo, la solicitud se seguirá contando en tu cuota.
¿Se factura GetTokens?
Las solicitudes a la API de GetTokens no se facturan y no se descuentan de la cuota de inferencia.
¿Cómo se manejan mis datos de Google AI Studio si tengo una cuenta de API pagada?
Consulta las Condiciones del Servicio para obtener detalles sobre cómo se manejan los datos cuando se habilita la facturación de Cloud (consulta "Cómo Google Usa sus Datos" en "Servicios Pagados"). Ten en cuenta que tus instrucciones de Google AI Studio se tratan según las mismas condiciones de "Servicios Pagados", siempre y cuando al menos 1 proyecto de API tenga habilitada la facturación, lo que puedes validar en la página de la clave de la API de Gemini si ves algún proyecto marcado como "Pagado" en "Plan".
¿Qué sucede cuando mi saldo de crédito prepagado llega a USD 0?
Todos los servicios de la API de Gemini en todos los proyectos pagados con esa cuenta de prepago de Facturación de Cloud se detendrán de inmediato para evitar que se generen más cargos. Tus proyectos no se cambian automáticamente al nivel gratuito.
Para restablecer el servicio en tu nivel de plan pagado actual, debes comprar créditos adicionales. Después de comprar créditos, deberías poder usar la API de Gemini. Ten en cuenta que puede haber una demora mientras nuestros sistemas se actualizan para reflejar el saldo de tu crédito.
De manera opcional, para cambiar a la capa gratuita, puedes inhabilitar la facturación en los proyectos a los que quieras cambiar.
¿Mis créditos prepagados vencen?
Sí, los créditos vencen 12 meses después de la fecha de compra.
¿Por qué el saldo de crédito de mi cuenta de prepago es negativo?
Debido a la complejidad de nuestros sistemas de facturación y procesamiento, es posible que haya demoras en nuestra capacidad de detener el uso después de que consumas todos tus créditos. Este uso adicional puede aparecer como un saldo de crédito negativo en el panel de facturación de AI Studio. Si esto sucede, se pausará el servicio y el saldo negativo se deducirá de tu próxima compra de crédito.
Para evitar que se pause tu servicio de la API de Gemini, te recomendamos que configures la recarga automática para comprar más créditos automáticamente cuando tu saldo de créditos sea inferior a un valor que especifiques.
¿Puedo usar mis créditos de prepago para otros servicios de Google Cloud, como Vertex AI?
No, los créditos de prepago se aplican estrictamente al uso de la API de Gemini. Cualquier otro servicio de Google Cloud que uses (Compute, Storage, Vertex) se facturará con el ciclo de cobro estándar de Cloud.
¿Por qué veo el mensaje "El tipo de cuenta de facturación está inactivo o no es compatible"?
Es posible que se bloqueen las interacciones de pagos en la página Facturación de AI Studio y se reemplacen por el mensaje "El tipo de cuenta de facturación está inactivo o no se admite" si el tipo de cuenta de facturación o el estado de la cuenta de facturación que seleccionaste no son aptos para el nivel pagado de AI Studio.
Consulta la consola de Cloud para ver el estado de tu cuenta de facturación. Un tipo no apto podría ser Cuenta de prueba gratuita, en cuyo caso puedes activar la facturación en AI Studio para cumplir con los requisitos. Un estado inactivo podría ser Cerrada, en cuyo caso puedes reabrir la cuenta.
¿Dónde puedo obtener ayuda con la facturación?
Para obtener ayuda con la facturación, consulta Obtén asistencia para la facturación de Cloud.