Proceso completo de integración de la API de Nano Banana 2: explicación detallada de los pasos de compra oficiales y recomendaciones de servicios proxy de API alternativos

Nota del autor: Guía paso a paso para completar el proceso de compra oficial de la API de Nano Banana 2 (vinculación de tarjeta en AI Studio + configuración de Vertex AI), análisis de las restricciones de red para usuarios fuera de EE. UU. y cómo APIYI actúa como una solución de respaldo para satisfacer las necesidades de tu negocio.

En el artículo anterior hablamos sobre la integración de Nano Banana Pro; en este, nos centraremos en su "hermano", Nano Banana 2 (gemini-3.1-flash-image-preview). Aunque ambos utilizan el modelo de imagen Gemini en su base, el proceso de integración de NB2 tiene algunas diferencias: en marzo de 2026, AI Studio cambió su sistema de facturación (a un modelo de prepago) y la configuración de Vertex AI también presenta variaciones. Este artículo te guiará paso a paso por todo el proceso de compra oficial y te ofrecerá a APIYI como una alternativa de respaldo, garantizando que puedas "conectar directamente con el oficial" y, al mismo tiempo, asegurar que tu negocio no se detenga si el servicio oficial falla o alcanza sus límites.

Valor central: Completa todo el proceso de compra oficial, comprende los costes y requisitos de cada paso, y ten preparada a APIYI como solución de respaldo para garantizar la continuidad de tu negocio.

Información clave para la integración oficial de la API de Nano Banana 2

Proceso 1: Compra e integración a través de AI Studio (pasos completos)

AI Studio es la opción preferida para la mayoría de los desarrolladores. En marzo de 2026 se actualizó el sistema de facturación, pasando de la facturación vinculada a GCP a un sistema de prepago/pospago integrado en AI Studio.

Paso 1: Crear una cuenta de Google e iniciar sesión en AI Studio

Nota para usuarios en China: Necesitarás una VPN para acceder a AI Studio. Además, incluso con VPN, Google detectará la región de registro de la cuenta; se recomienda usar una cuenta de Gmail de EE. UU.

Paso 2: Generar la clave API

En este punto, obtendrás una clave de nivel gratuito. Nano Banana 2 es prácticamente inutilizable en este nivel (el RPD es extremadamente bajo o nulo), por lo que es obligatorio actualizar al nivel de pago.

Paso 3: Vincular método de pago y recargar saldo

Desde el 23 de marzo de 2026, AI Studio utiliza un nuevo sistema de facturación:

Pasos para la recarga de prepago:

1. Entrar en AI Studio → página de Billing (Facturación)
2. Hacer clic en "Buy Credits"
3. Seleccionar el monto de recarga ($10 / $50 / $100 / personalizado, hasta $5,000)
4. Introducir la información de la tarjeta de crédito

Tarjetas de crédito admitidas: Visa, Mastercard, American Express, Discover, JCB

Obstáculo para usuarios en China: Se requiere una tarjeta de crédito internacional. Las tarjetas UnionPay nacionales no son aceptadas. Necesitarás una tarjeta de crédito extranjera Visa/Mastercard o utilizar un servicio de tarjeta de crédito virtual.

Paso 4: Escribir código para la invocación del modelo

from google import genai
from google.genai import types

client = genai.Client(api_key="TU_CLAVE_DE_AI_STUDIO")

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents=["Un golden retriever corriendo en la playa, sol de tarde"],
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(
            image_size="4K",
            aspect_ratio="16:9"
        ),
    )
)

for part in response.parts:
    if image := part.as_image():
        image.save("output.png", format="PNG")

Paso 5: Monitorear el uso y los costos

El proceso completo toma entre 30 y 45 minutos (incluyendo el tiempo de espera para la verificación de la tarjeta de crédito).

Proceso 2: Adquisición e integración de Vertex AI (Nivel empresarial)

Vertex AI es la opción ideal para usuarios empresariales que requieren SLA, control de permisos IAM y certificaciones de cumplimiento.

Resumen de pasos para la integración con Vertex AI

Tiempo total estimado: 2-3 horas.

Precios de Vertex AI

Exactamente igual que en AI Studio: 2K $0.067/unidad, 4K $0.151/unidad. Sin descuentos.

El valor añadido de Vertex AI reside en: garantía de SLA del 99.9%, permisos IAM granulares, aislamiento de red VPC y cuotas de RPM personalizables.

Restricciones de red en Vertex AI

Al igual que en AI Studio, no es posible conectarse directamente a aiplatform.googleapis.com desde China continental o Rusia. Los usuarios empresariales suelen desplegar servidores intermedios en Singapur o Japón para realizar el reenvío mediante proxy.

Estrategia de respaldo de APIYI: ¿Por qué usar un "sistema de doble vía"?

Algunos desarrolladores preguntan: si APIYI es más barato y sencillo, ¿por qué mantener la conexión directa oficial?

Escenarios donde la conexión directa oficial sirve como respaldo

Escenarios donde APIYI sirve como respaldo (y son más)

Arquitectura recomendada: Priorizar APIYI (ahorro + estabilidad), con la oficial como respaldo (aunque si la oficial se cae, no hay mucho que hacer).

Código de integración de APIYI (solo cambia una línea respecto al oficial)

import openai

# Integración con APIYI: cambia una línea en base_url
client = openai.OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{
        "role": "user",
        "content": "Un golden retriever corriendo en la playa, luz de tarde"
    }]
)

import openai

# Principal: APIYI (barato + estable)
apiyi_client = openai.OpenAI(
    api_key="APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# Respaldo: Conexión directa oficial
from google import genai
official_client = genai.Client(api_key="GOOGLE_KEY")

def generate_image(prompt: str):
    """Doble vía: APIYI primero, degradar a oficial si falla"""
    try:
        # Primera opción: APIYI ($0.045/imagen, estable)
        response = apiyi_client.chat.completions.create(
            model="gemini-3.1-flash-image-preview",
            messages=[{"role": "user", "content": prompt}]
        )
        return response, "apiyi"
    except Exception as e:
        print(f"Fallo en APIYI: {e}, cambiando a conexión oficial...")
        try:
            # Respaldo: Conexión directa oficial ($0.151/imagen)
            from google.genai import types
            response = official_client.models.generate_content(
                model="gemini-3.1-flash-image-preview",
                contents=[prompt],
                config=types.GenerateContentConfig(
                    response_modalities=["TEXT", "IMAGE"],
                ),
            )
            return response, "official"
        except Exception as e2:
            print(f"La oficial también falló: {e2} (si la oficial se cae, no hay nada que hacer)")
            return None, "both_failed"

🎯 Sugerencia de arquitectura: Usa APIYI para el día a día (ahorro + estabilidad) y mantén la ruta de código de conexión directa oficial. Si APIYI falla, cambia a la oficial; si la oficial falla, cambia a APIYI. Se respaldan mutuamente para que tu negocio nunca se detenga (a menos que ambos fallen, lo cual significaría un fallo en la infraestructura de Google, ante lo cual nadie puede hacer nada).

Diferencias de integración oficial: Nano Banana 2 vs Nano Banana Pro

Si leíste el artículo anterior sobre NB Pro, aquí detallo las diferencias clave para la integración de NB2:

Preguntas frecuentes

Resumen

Puntos clave para la integración de la API de Nano Banana 2:

1. Ambas vías oficiales requieren tarjeta y pago a precio completo: AI Studio se configura en 30 minutos pero requiere tarjeta extranjera y cuesta $0.151/imagen; Vertex AI toma de 2 a 3 horas pero ofrece SLA. Ambos no pueden conectarse directamente desde China/Rusia.
2. APIYI es la mejor solución para respaldo y ahorro: Integración en 5 minutos, $0.045/imagen 4K (28% del precio original), conexión directa global, sin necesidad de tarjeta extranjera, pago por uso y sin cargos por fallos. Satisface la gran mayoría de las necesidades empresariales.
3. La arquitectura de doble vía es la más segura: Usa APIYI para el día a día y ahorrar costes, manteniendo la ruta de código oficial como respaldo. Ambos se sirven de apoyo mutuo para que el negocio nunca se detenga (si el oficial se cae, realmente no hay nada que hacer, pero ese colapso total es extremadamente raro).

Se recomienda integrar la API de Nano Banana 2 a través de APIYI en apiyi.com: $0.045 por 4K, conexión directa global, configuración en 5 minutos y saldo de prueba gratuito al registrarse.

📚 Referencias

1. Guía oficial para desarrolladores de Nano Banana 2: Tutorial de Google sobre cómo integrar y utilizar NB2.

   • Enlace: blog.google/innovation-and-ai/technology/developers-tools/build-with-nano-banana-2/
   • Descripción: Incluye capacidades del modelo, ejemplos de código y mejores prácticas.

2. Documentación de facturación de AI Studio: Nuevo sistema de facturación prepago/pospago.

   • Enlace: ai.google.dev/gemini-api/docs/billing
   • Descripción: Explicación detallada del nuevo sistema vigente desde el 23/03/2026.

3. Límites de tasa de la API de Gemini: Límites oficiales y explicación de niveles.

   • Enlace: ai.google.dev/gemini-api/docs/rate-limits
   • Descripción: Cuotas específicas para el nivel gratuito/Nivel 1/Nivel 2/Nivel 3.

4. Centro de documentación de APIYI: Guía de integración de Nano Banana 2 a $0.045 por imagen 4K.

   • Enlace: docs.apiyi.com
   • Descripción: Integración en 5 minutos + conexión directa global + facturación por uso + sin cargos por fallos.

Autor: Equipo técnico de APIYI
Intercambio técnico: Te invitamos a participar en la sección de comentarios. Para más información, visita el centro de documentación de APIYI en docs.apiyi.com.