"Recargar" la API de Gemini no es lo mismo que recargar el monedero de una plataforma local. El canal oficial suele facturar por consumo a través de una cuenta de facturación de Google Cloud: en la mayoría de los casos se paga después de consumir y no existe un "saldo de API" consultable en todo momento. Una pasarela de IA, en cambio, se parece más a un monedero prepago: primero se recarga, luego se descuenta, y el saldo y la facturación viven en el mismo panel.
Ninguna de las dos vías es mejor en abstracto; las diferencias están en el método de pago, la velocidad de acreditación, el tipo de factura y el costo operativo. Este artículo recorre ambas, con énfasis en cómo confirmar la acreditación, cómo conciliar las cuentas y cómo gestionar la factura, además de los errores más habituales.
Nota: Google y Gemini son marcas de sus titulares. Este artículo toma como ejemplo los procesos habituales de octubre de 2026; la interfaz, los métodos de pago, los precios y las reglas de facturación se rigen por las páginas oficiales y por los precios de modelos del sitio.
1. Distingue primero dos tipos de "recarga"
| Dimensión | Canal oficial | Pasarela de IA en China |
|---|---|---|
| Forma de facturación | Cuenta de facturación vinculada y cargos por consumo | Saldo prepago con descuento por consumo |
| Momento del pago | Se paga después de consumir, según el ciclo | Primero se recarga, luego se usa |
| Moneda de liquidación | Normalmente dólares | Yuanes (RMB) |
| Método de pago | Métodos internacionales admitidos por la plataforma | Transferencia corporativa o pago en línea |
| Velocidad de acreditación | Activación inmediata; la factura llega después | Suele acreditarse poco después del pago |
| Factura | Comprobante de facturación de la plataforma, según reglas oficiales | Factura fiscal general o especial, según la plataforma |
| Perfil adecuado | Equipos con pagos y reembolsos internacionales | Equipos que necesitan pagar en yuanes y recibir factura |
Antes de empezar, aclara si el problema es "no tengo un método de pago disponible" o "necesito una factura en moneda local": la solución es distinta en cada caso. Si solo haces pruebas ocasionales, el nivel gratuito oficial puede bastar; para sostener un negocio, diseña sobre el nivel de pago y el contrato.
2. Canal oficial: pasos para activar el nivel de pago
- Inicia sesión con una cuenta de Google en AI Studio o en la consola de Google Cloud, y crea o selecciona un proyecto.
- Vincula una cuenta de facturación de Cloud al proyecto y completa el nombre de la empresa, la dirección y los datos fiscales.
- Confirma que el método de pago esté disponible y completa la verificación que indique la página.
- Habilita la API de Gemini en el proyecto y espera a que el permiso se active.
- Crea una clave de API, limita las API y los orígenes permitidos, y no uses la clave predeterminada sin restricciones.
- Configura presupuestos y alertas de uso que cubran al menos el presupuesto mensual y los picos anómalos.
- Valida con una petición mínima que el nivel de pago está activo y que no sigues en el nivel gratuito.
Lo clave del canal oficial no es "cuánto recargaste", sino si la cuenta de facturación está correcta, si el proyecto está bien vinculado y si la clave pertenece a ese proyecto. El retraso en la facturación es normal; no asumas que el servicio es gratuito porque ese día no viste ningún cargo.
3. Recarga en la pasarela: del registro al uso
- Regístrate en ZSQH AI Gateway y completa los datos de la entidad según las indicaciones.
- Entra en la página de recarga, elige el importe y el método de pago, y confirma el beneficiario y los datos del contrato.
- Completa el pago y conserva el número de pedido y el comprobante.
- Confirma en el panel que el saldo o la cuota se actualizó; actualiza la página si es necesario.
- Crea una clave de API, nómbrala por proyecto y define el rango de modelos permitidos.
- Valida con una petición mínima la clave, el saldo y los permisos de modelo.
Para recargas empresariales se recomienda el pago corporativo y archivar juntos contrato, pedido, comprobante y factura. No recargues el negocio de la empresa desde una cuenta personal: los reembolsos y las auditorías posteriores exigirán explicaciones.
4. Cómo verificar la acreditación
No te quedes con la pantalla de "pago exitoso". Confirma con una petición mínima que la clave funciona de verdad y registra los campos de uso devueltos.
export GEMINI_API_KEY="tu_clave"
# Interfaz nativa oficial
curl "https://generativelanguage.googleapis.com/v1beta/models/<ID-del-modelo>:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Responde solo OK"}]}]}'
# Entrada compatible con OpenAI de la pasarela
curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
-H "Authorization: Bearer $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<nombre-del-modelo>","messages":[{"role":"user","content":"Responde solo OK"}]}'
La respuesta oficial suele incluir usageMetadata, donde se ven los tokens de entrada, de salida y el total; el panel de la pasarela normalmente muestra el uso y el cargo de esa petición. Solo cuando ese número coincide con el cambio de saldo puedes dar la recarga por acreditada.
5. Facturas y conciliación
| Concepto | Canal oficial | Pasarela en China |
|---|---|---|
| Comprobante principal | Facturación, recibos o documentos fiscales de la plataforma | Factura fiscal |
| Moneda | Dólares | Yuanes (RMB) |
| Ciclo de facturación | Según las reglas de la plataforma | Según las reglas de la plataforma; normalmente hay que solicitarla |
| Titular y número fiscal | Según los datos de la cuenta de facturación | Se envían los datos fiscales de la empresa |
| Dimensiones de conciliación | Proyecto, servicio y ciclo de facturación | Recarga, cargos, modelo y clave |
A finanzas no le importa solo "si hay factura": también si el titular coincide, si el importe se puede desglosar por proyecto y cómo se anula un reembolso. Preguntar esto antes de recargar ahorra mucho más que reunir documentos después.
6. Cinco errores comunes
- Recargar en la cuenta equivocada: en el canal oficial puede haber varios proyectos; la cuenta de facturación y el proyecto no son lo mismo. Confirma primero la relación entre ambos.
- Clave de otro proyecto: la clave nueva parece correcta, pero el consumo se registra en el proyecto antiguo. Crea claves por proyecto y ponles un nombre claro.
- Confundir el nivel gratuito con el de pago: el nivel gratuito tiene límites de velocidad y condiciones propias; para producción, confirma que el nivel de pago esté activo.
- Ignorar el tipo de cambio y las comisiones: el importe real de un pago transfronterizo puede diferir del mostrado; concilia con el comprobante bancario.
- No revisar reembolsos y vigencia: si el saldo no usado es reembolsable, si caduca y qué pasa con los créditos de regalo se rige por los términos de la plataforma.
Preguntas frecuentes
¿Se puede recargar saldo en la API de Gemini como en una plataforma local?
El canal oficial normalmente factura por consumo mediante una cuenta de facturación de Cloud, no como un monedero; el modelo de facturación y los métodos de pago se rigen por la página oficial. Los equipos que necesitan una experiencia prepago pueden evaluar una pasarela local.
¿Cuánto tarda en acreditarse una recarga?
La activación oficial suele ser inmediata y la factura llega después; en una pasarela, el saldo suele acreditarse poco después del pago. Si hay demora, revisa el estado del pedido y los avisos de la plataforma antes de pagar de nuevo.
¿La recarga en la pasarela permite obtener factura fiscal?
Se rige por las reglas de facturación de la plataforma. Antes de registrarte y recargar, confirma el titular fiscal, el número de identificación, el ciclo de facturación y el proceso de anulación por reembolso; en compras empresariales conviene dejarlo en el contrato o en las notas del pedido.
¿Se puede reembolsar el saldo no utilizado?
Cada plataforma tiene sus reglas, y el tratamiento del saldo no usado, los créditos promocionales y el consumo ya realizado puede variar. Lee los términos antes de pagar y no des por hecho que se devuelve por la misma vía.
¿Por qué sigue fallando la llamada después de recargar?
Distingue primero autenticación, saldo y permisos de modelo: 401 apunta a la clave, 403 al proyecto o a los permisos del modelo, 429 a la velocidad, y el saldo insuficiente suele tener un mensaje propio. Revisa cada punto en orden en lugar de recargar una y otra vez.
Siguiente paso
Si necesitas recargas en yuanes, facturación unificada y facturas, empieza con una recarga pequeña en ZSQH AI Gateway, ejecuta una petición y verifica el cargo antes de ampliar al negocio real. Los modelos disponibles y los precios se rigen por los precios de modelos.
Lecturas relacionadas:
