Comprar la API de Gemini para una empresa se reduce con facilidad a «cuánto cuesta el millón de tokens». Lo que de verdad decide si un proyecto llega a producción es la cuota, la velocidad, los términos de datos, la gestión de cuentas y claves, la conciliación de la factura y la existencia de un plan de respaldo cuando falla el canal principal.

Este artículo ofrece una lista de verificación siguiendo el orden de compra y puesta en marcha. Los modelos y precios concretos se rigen por la página de precios de modelos y por la documentación de Google; aquí no se fijan tarifas unitarias ni se emiten conclusiones jurídicas por ninguna de las partes.

Nota: Google y Gemini son marcas de Google LLC. Los términos, las regiones y las reglas de cuota de Google AI Studio y Vertex AI pueden ser distintos; prevalecen el contrato firmado, los términos oficiales y la configuración real de la consola. ZSQH AI Gateway es una pasarela de API independiente de terceros; este artículo solo trata métodos de integración y compra.

1. Primero calcula la carga de trabajo, después habla de cuota

Antes de comprar hay que responder cuatro preguntas; de lo contrario, la cuota se elige a ojo.

  1. ¿Cuántas solicitudes hay al día y en qué horas se concentra el pico?
  2. ¿Cuántos tokens hay de entrada y de salida en promedio, y cuánto miden el 5 % más largo?
  3. ¿Qué proporción de imágenes, audio, video y PDF hay, y qué tamaño tiene cada material?
  4. ¿Cuántas solicitudes adicionales generan la tasa de reintentos, la tasa de fallos y el reenvío de mensajes históricos?

Agrupa los logs de la última semana por modelo, tipo de tarea y longitud de entrada; calcula solicitudes diarias, tokens diarios y concurrencia máxima, multiplica por 30 para obtener la línea base mensual y añade un margen de reintentos del 20 % al 30 %. En proyectos nuevos sin logs, ejecuta una semana con poco tráfico; no estimes a la fuerza con «número de usuarios × veces».

2. Cuota, velocidad y facturación

El plan gratuito de AI Studio sirve para validar, pero la velocidad y la cuota son más estrictas y los términos de datos pueden ser distintos. Planifica producción con el plan de pago e incluye estos puntos en la orden de compra:

  • Si la entidad de facturación es una cuenta extranjera o una empresa local, y cómo se gestionan la moneda y el tipo de cambio.
  • Si se usa prepago o pospago, y cómo se configuran las alertas de saldo y la recarga automática.
  • Si la cuota se asigna por proyecto o por equipo, y quién puede solicitar un aumento temporal.
  • La estrategia de reintento, cola y degradación cuando aparece un 429.
  • El tipo de factura, el ciclo de facturación y los campos necesarios para la conciliación.

La conexión directa con el proveedor suele liquidarse en dólares y encaja en equipos que ya tienen un proceso de pago internacional. Los equipos que necesitan factura en RMB y una factura unificada para varios modelos pueden evaluar una pasarela local. Las dos rutas tienen estructuras de costo distintas; no basta con comparar el precio de lista.

3. Datos y cumplimiento: pregunta antes de firmar

El límite de cumplimiento depende de la entrada que se use, de las funciones activadas y de la región donde se almacenen los datos. Antes de comprar, prepara una lista escrita de preguntas y entrégala a las áreas legal, de seguridad y de negocio:

  1. ¿Las entradas y salidas se usan para entrenar modelos, y los términos empresariales establecen algo distinto?
  2. ¿Cuánto tiempo se conservan los datos, cómo se solicita la eliminación y cuánto tarda en aplicarse?
  3. ¿En qué regiones se almacenan los datos y se cumplen los requisitos de residencia de la empresa o de los clientes?
  4. ¿Se puede firmar un acuerdo de procesamiento de datos y cómo se delimitan la responsabilidad y el límite de indemnización?
  5. ¿Qué subprocesadores existen y se avisa con antelación cuando cambian?
  6. ¿Los logs, la caché y la carga de archivos están activados por defecto, y se pueden desactivar o acortar sus plazos de retención?

No aceptes respuestas verbales. Archiva la política de privacidad, el acuerdo de procesamiento de datos, la documentación de seguridad y la lista de subprocesadores como material de aceptación. Si hay datos personales o transferencias transfronterizas, anonimiza primero y pide a legal que confirme la ruta.

4. Cuentas, permisos y gestión de claves

El mayor riesgo de una cuenta empresarial es «una sola clave para toda la empresa». Orden recomendado de implementación:

  1. Regístrate con un correo del dominio corporativo y vincula la organización a la empresa; no uses cuentas personales para el negocio.
  2. Separa proyectos de Cloud o espacios de trabajo para producción, pruebas y desarrollo, con facturación y cuota independientes.
  3. Da permisos de administrador solo a unas pocas personas, activa la autenticación de dos factores y revisa los miembros cada trimestre.
  4. Usa cuentas de servicio o claves independientes para las llamadas de negocio, no credenciales de administrador.
  5. Etiqueta cada clave con responsable, uso, entorno y fecha de creación; revócala cuando la persona deje el equipo.
  6. Activa los logs de auditoría y las alertas de uso; ante llamadas anómalas, desactiva primero la clave y después localiza el origen.

Guarda las claves solo en variables de entorno del servidor o en un gestor de secretos; nunca en el frontend, el repositorio o capturas de tickets. Para demostraciones usa una clave aparte de baja cuota y elimínala al terminar.

5. Control de costos: atacar la arquitectura, no solo cambiar de proveedor

El costo de Gemini depende del nivel del modelo, la longitud de entrada y salida, los materiales multimodales y los reintentos. El orden debe ser: gobernar primero la entrada, después enrutar por niveles y por último comparar tarifas.

  • Fija el prompt del sistema y el prefijo de los documentos largos, y usa la caché de contexto para reducir la entrada repetida.
  • Envía clasificación, extracción y reescritura al nivel ligero; sube al superior solo para razonamiento complejo.
  • Define maxOutputTokens y pide JSON o campos fijos para evitar respuestas extensas.
  • Baja la resolución de las imágenes, reduce la frecuencia de muestreo de video y envía solo las páginas relevantes de los PDF.
  • Ejecuta las tareas sin urgencia en lotes, aceptando una cola a cambio de un menor costo.
  • Pon un límite y retroceso a los reintentos; durante un 429 no aumentes el volumen de solicitudes.
  • Registra el uso por proyecto, equipo y tarea para imputar costos internamente.

Tras integrar la pasarela, puedes solicitar con el SDK de OpenAI y verificar el uso en la respuesta:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZSQH_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="<nombre del modelo Gemini en la página de precios>",
    messages=[{"role": "user", "content": "Responde solo OK"}],
    max_tokens=64,
)

print(resp.usage)

El nombre del modelo se rige por la página de precios de modelos; no reutilices nombres de documentación antigua. Antes de lanzar una tarea nueva, mide con muestras reales «el costo de completar una tarea aceptable», no solo el precio de una solicitud.

6. Proveedor de respaldo y plan de degradación

La compra empresarial debe asumir que el canal principal puede fallar. Prepara al menos tres capas: un modelo alternativo del mismo fabricante, un modelo de otro fabricante y un mecanismo de degradación en el negocio, como mensajes predefinidos o resultados en caché.

Abstrae la llamada al modelo en una interfaz unificada y configura tiempos de espera, reintentos, cortacircuitos e interruptores de cambio; el cambio debe completarse en menos de un minuto y sin modificar el código de negocio. Haz un simulacro cada trimestre para confirmar que la clave, la cuota y el nombre del modelo del canal de respaldo funcionan; deja por escrito en el contrato el nivel de servicio y las condiciones de salida.

7. Piloto y aceptación: plan de evaluación de cuatro semanas

Se recomienda un piloto de cuatro semanas en pequeño alcance en lugar de migrar todo de una vez.

Etapa Responsable R Aprueba A Colabora C Informado I Entregable
Requisitos y cálculo de cuota Responsable de negocio Jefe de área Finanzas y tecnología Compras Tabla de línea base de uso
Evaluación de datos y cumplimiento Seguridad y cumplimiento Legal Tecnología y compras Dirección Lista de riesgos y conclusión
Configuración de cuentas y permisos Administrador de plataforma Responsable técnico Seguridad Negocio Lista de proyectos y claves
Integración técnica y prueba de carga Responsable de desarrollo Responsable técnico Operaciones Negocio Informe de integración y registro de carga
Monitoreo de costos y conciliación Finanzas Responsable de finanzas Tecnología y compras Dirección Informe semanal de costos
Contrato y pago Compras Responsable de finanzas Legal Negocio Contrato, factura y comprobante
Aceptación del lanzamiento Responsable de negocio Jefe de área Tecnología y seguridad Dirección Acta de aceptación firmada

La primera semana se valida la interfaz y los permisos; la segunda se compara la calidad con muestras reales; la tercera se hace la prueba de pico y el simulacro de fallos; la cuarta se consolidan los costos y se presenta la aceptación. Los indicadores incluyen precisión de la tarea, latencia P95, tasa de errores y de reintentos, costo por tarea y revisión de claves y permisos; los umbrales concretos los define cada equipo según su negocio.

8. Preguntas que deben hacerse en el contrato

  1. ¿Cómo se define el nivel de servicio, cuál es el criterio de medición y cómo se compensa?
  2. ¿Con cuánta antelación se avisa un cambio de precio y afecta a la cuota ya comprada?
  3. ¿Cuál es el proceso de solicitud de aumento de cuota y el tiempo de respuesta?
  4. ¿Se pueden incluir en el contrato el acuerdo de procesamiento de datos, las restricciones regionales y el proceso de eliminación?
  5. ¿Cuáles son el tipo de factura, la moneda, el ciclo de pago y las reglas de reembolso?
  6. ¿Cuáles son los canales de soporte, los tiempos de respuesta y la ruta de escalado?
  7. ¿Cómo se exportan y eliminan los datos al terminar la relación?
  8. ¿Cómo se notifican los cambios de subprocesadores y los incidentes de seguridad?

Preguntas frecuentes

¿Es obligatorio usar Vertex AI para comprar Gemini API en una empresa?

No necesariamente. Vertex AI encaja mejor en equipos con requisitos altos de región de datos, IAM, auditoría y entidad contractual; AI Studio puede servir para validar rápido y para negocios pequeños. Confirma primero que los términos y la cuota cubren el negocio y después decide la entrada.

¿Se puede usar la cuota gratuita en producción?

No es recomendable. La velocidad, la cuota y los términos de datos del plan gratuito suelen diferir del plan de pago, y una limitación repentina afecta la experiencia. Planifica producción con el plan de pago y reserva el gratuito para prototipos y pruebas internas.

¿Los datos de Gemini API se usan para entrenamiento?

La respuesta puede variar según el producto, los términos y la configuración. Rigen el acuerdo de procesamiento de datos y los términos oficiales; con datos sensibles, anonimiza primero y pide a legal que confirme las condiciones de retención y entrenamiento.

¿Qué hacer si la cuota no alcanza o aparecen 429 con frecuencia?

Distingue primero si es un límite de velocidad o un límite total de cuota; después optimiza reintentos, concurrencia y longitud de las solicitudes. Si confirmas que el crecimiento del negocio es la causa, solicita un aumento de cuota o añade un canal de respaldo. Reenviar a ciegas solo empeora la situación.

¿Cómo demostrar que el costo es controlable después de la compra?

Crea una línea base de uso antes del lanzamiento y, después, un informe semanal por proyecto con el costo por tarea, los aciertos de caché, la tasa de reintentos y la proporción por nivel de modelo. Solo se considera controlable si durante cuatro semanas consecutivas se mantiene dentro del presupuesto y con la calidad acordada.

Siguiente paso

Crea primero una clave de prueba en ZSQH AI Gateway con una tarea real y valida los modelos, la latencia y la factura en RMB; después separa las claves definitivas por entorno. Los precios se rigen por la página de precios de modelos; antes de comprar, entrega la lista a finanzas, legal y tecnología para que cada área la revise.

Lecturas relacionadas: